Audiences & contacts

Audiences are named lists of contacts for broadcast sending. Contacts are included with every plan (Free: 1,500 · Launch: 5,000 · Build: 25,000 · Grow: 100,000) — there is no separate marketing subscription.

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
`email`required	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).