Skip to Content
Docs
API referenceAudiences

Add one contact to an audience

POST
/v1/audiences/{id}/members

Idempotent — re-adding an existing member is a no-op (200), not an error. On a genuine add, enrolls the contact into any active audience_added-triggered automation configured for this audience.

Authorization

bearerAuth
headerAuthorizationBearer <token>

API key sent as Authorization: Bearer <key>. Looked up by SHA-256 hash (email_core::sha256_hex) against api_keys.hash; revoked keys and keys belonging to a suspended tenant are rejected. See the top-level Authentication section for permission levels.

Path Parameters

id*string

Request Body

application/json
  1. body
contact_id*string

Response Body

Already a member.

application/json
  1. response
audience_id?string
contact_id?string
added?boolean
Example Request
curl -X POST 'https://api.emitd.com/v1/audiences/string/members' \  -H 'Content-Type: application/json' \  -d '{  "contact_id": "string"}'
Example Response
{  "audience_id": "string",  "contact_id": "string",  "added": true}