Audiences & contacts
Audiences are named lists of subscribed contacts. Free includes 1,000 active marketing contacts for broadcasts. Pro includes 10,000 contacts, adds automations, then bills extra active contacts at $1.50 per 1,000 per month until the custom-plan threshold.
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).