<Intro>

<EndpointHeader />

<Description>

Creates an audience in the workspace. New audiences start empty: add members with [Add contacts to an audience](/docs/api/reference/assign-audience-contacts) or through [Create or update contacts in bulk](/docs/api/reference/create-contact-batch). Only `static` audiences can be created today; requesting `dynamic` or `external` returns a validation error.

</Description>

</Intro>

<Payload kind="request">

<Field name="name" type="string" required>

<Description>

Display name for the audience.

</Description>

</Field>

<Field name="description" type="string">

<Description>

Longer description of who this audience is.

</Description>

</Field>

<Field name="type" type="string">

<Description>

How the audience's recipients are determined. `static` (the default) is an explicit member list you manage via the API. `dynamic` and `external` are preview values and currently unavailable; creating an audience with either returns a validation error.

</Description>

<Description>

Possible values: `static`, `dynamic`, `external`

</Description>

</Field>

</Payload>

<Payload kind="response">

<Field name="id" type="string" required>

<Description>

ID of the audience (`adn_`-prefixed), accepted by every operation that takes an `audience_id`.

</Description>

</Field>

<Field name="name" type="string" required>

<Description>

Display name for the audience.

</Description>

</Field>

<Field name="description" type="nullable string">

<Description>

Longer description of who this audience is.

</Description>

</Field>

<Field name="type" type="string" required>

<Description>

How the audience's recipients are determined. `static` (the default) is an explicit member list you manage via the API. `dynamic` and `external` are preview values and currently unavailable; creating an audience with either returns a validation error.

</Description>

<Description>

Possible values: `static`, `dynamic`, `external`

</Description>

</Field>

<Field name="created_at" type="string" required />

<Field name="updated_at" type="string" required />

</Payload>