Sign in

v53

latestOpenAPI 3.1.1raw.githubusercontent.com2026-07-264065213.4 KB
Audiences

Add a contact to an audience

Adds an existing contact to a manual audience.

post/audiences/{audience_id}/contacts

Path parameters

audience_idstring required

The audience ID to add the contact to.

Example:aud_01j9a43avnfqzbjfch6pygv1td

Request body

idstring required

The ID of the contact to add. The contact must belong to the same account as the audience.

Example request

{
  "id": "ctc_01j9dy8mdzfn3r0e8x1tbdrdrf"
}

Response

The contact, now a member of the audience

emailstring email

The contact's email address.

first_namestring

The contact's first name.

idstring required

Unique identifier for the object.

last_namestring

The contact's last name.

metadataMetadata

Set of key-value pairs that will be stored with the object.

phone_numberstring phone-number required

The contact's phone number in E.164 format.

Example response

{
  "email": "dom@toretto.family",
  "first_name": "Dominic",
  "id": "ctc_01j9dy8mdzfn3r0e8x1tbdrdrf",
  "last_name": "Toretto",
  "metadata": {
    "car": "1970 Dodge Charger R/T"
  },
  "phone_number": "+18015551234"
}