Audiences & contacts
Audiences are named lists of subscribed contacts. Free has no marketing contacts or automations. Pro includes 10,000 contacts and automations, while Scale includes 100,000 contacts and 200,000 automation runs in the same workspace plan. Upgrade the package as the audience grows; contacts do not accrue a separate overage.
For the product overview, read the audience management guide.
Consent required: only add contacts who opted in. Purchased or scraped lists get accounts paused.
Create an audience
POST/api/v1/audiences
curl -X POST https://www.noticeapi.com/api/v1/audiences \
-H "Authorization: Bearer ntc_xxxxxxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{ "name": "Product updates" }'Add contacts
POST/api/v1/audiences/:id/contacts
Adding an existing email updates the contact (upsert). New contacts start subscribed.
curl -X POST https://www.noticeapi.com/api/v1/audiences/AUDIENCE_ID/contacts \
-H "Authorization: Bearer ntc_xxxxxxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{ "email": "[email protected]", "firstName": "Fan" }'| Field | Type | Description |
|---|---|---|
emailrequired | string | The contact's address (unique per audience). |
firstName / lastName | string | Available as merge tags in broadcasts. |
Manage
GET /api/v1/audiences lists audiences; GET .../:id/contacts lists contacts; PATCH .../contacts/:id updates names or the subscribed flag; DELETE removes contacts or whole audiences. Unsubscribed contacts are skipped by every broadcast automatically and permanently (until they re-opt-in).