Audience management

Audience Management API for Consent-Based Email

NoticeAPI audiences give developers the recipient state needed for product updates, newsletters, and onboarding sequences. Create lists, upsert contacts, store merge fields, and let broadcasts and automations respect subscription state automatically.

Create an audience and add a contact
curl -X POST https://www.noticeapi.com/api/v1/audiences \
  -H "Authorization: Bearer ntc_xxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Product updates" }'

curl -X POST https://www.noticeapi.com/api/v1/audiences/aud_xxxxxxxx/contacts \
  -H "Authorization: Bearer ntc_xxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{ "email": "[email protected]", "firstName": "Sam", "subscribed": true }'

Audience CRUD

Create and manage audiences for product updates, newsletters, launches, and onboarding flows.

Contact upserts

Add or update contacts with email, name fields, subscription state, and merge metadata.

Broadcast and automation source

Broadcasts fan out to subscribed contacts; automations start when contacts enter an audience.

Unsubscribe-aware

Unsubscribed contacts are skipped, and suppressions still apply before any send leaves the platform.

How it works

From test send to production traffic.

1

Create an audience

Use an audience for one product, newsletter, lifecycle segment, or launch list.

2

Upsert contacts

Sync email addresses and merge fields from your product database.

3

Send a broadcast or sequence

Use the audience as the recipient source for product updates or onboarding automations.

4

Respect recipient state

Unsubscribes, suppressions, and contact subscription flags are checked before sending.

Trust

Contact state for email, not a sales database

Audience management is intentionally narrow: subscribed contacts, merge fields, broadcasts, automations, and unsubscribe state for product email.

Implementation links

Build with the shipped docs.

FAQ

Questions developers ask before switching email.

Can I import opted-in product users?

Yes. Use the contacts API to upsert recipients who have a legitimate relationship with your product and can receive the message you plan to send.

Do unsubscribed contacts receive broadcasts?

No. Broadcasts and automations skip unsubscribed contacts automatically.

Is this a full sales database?

No. Audiences are scoped to email recipient state, merge fields, broadcasts, automations, and unsubscribe handling.

Start free. Send production after your domain is ready.

Free includes 3,000 production emails per month, a 100/day production cap, and one verified sending domain.