<Intro>

<EndpointHeader />

<Description>

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.

</Description>

</Intro>

<Parameters in="path">

<Parameter name="audience_id" type="string">

<Description>

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

</Description>

</Parameter>

</Parameters>

<Payload kind="request">

<Field name="contact_ids" type="array of string" required>

<Description>

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.

</Description>

</Field>

</Payload>