Email Marketing

Audiences

An audience is a list. Contacts join an audience when you upsert them with an audience id, or when you sync a batch into one list.

List and create

GET/api/v1/email/audiencesaudiences:read

POST/api/v1/email/audiencesaudiences:write

Create returns 201. A duplicate name returns 409. The API does not merge two lists that share a name.

name	Required. Unique inside the organization.
description	Optional.
doubleOptIn	Optional boolean. Audience-level double opt-in setting.

curl

curl -sS https://api.thealtermeai.com/api/v1/email/audiences \
  -H "Authorization: Bearer emk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Product updates","description":"Launch notes","doubleOptIn":false}'

One audience

GET/api/v1/email/audiences/{audienceId}audiences:read

PATCH/api/v1/email/audiences/{audienceId}audiences:write

DELETE/api/v1/email/audiences/{audienceId}audiences:write

Delete returns 204. Use the id from the list or create response on contact and campaign calls.