Add contacts to an audience

POST

/v1/audiences/{audience_id}/contacts

curl -X POST "https://us1.platform.bird.com/v1/audiences/{audience_id}/contacts" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "contact_ids": [
      "con_01krdgeqcxet5s7t44vh8rt9mg"
    ]
  }'

Adds up to 1,000 contacts to an audience. Adding is idempotent: contacts that are already members are left in place and keep their original join time. If any contact ID does not exist in the workspace, the whole request fails with a validation error and no contacts are added.

Parameters

audience_id

string

ID of the audience to add contacts to (adn_-prefixed).

Request Payload

contact_ids

array of string

required

Contacts to add to the audience. Adding a contact that is already a member has no effect and keeps its original join time; duplicate IDs in the list are collapsed. If any ID does not exist in the workspace, the whole request fails with a validation error and no contacts are added.

curl -X POST "https://us1.platform.bird.com/v1/audiences/{audience_id}/contacts" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "contact_ids": [
      "con_01krdgeqcxet5s7t44vh8rt9mg"
    ]
  }'