Sign inGet Started

Create an audience

POST
/v1/audiences
const audience = await bird.audiences.create({
  name: "Newsletter subscribers",
});
console.log(audience.id); // "adn_…"
Odpowiedź201
{
  "id": "adn_01krdgeqcxet5s7t44vh8rt9mg",
  "name": "Newsletter subscribers",
  "type": "static",
  "created_at": "2026-05-20T09:14:52Z",
  "updated_at": "2026-05-25T16:42:01Z"
}

Creates an audience in the workspace. New audiences start empty: add members with Add contacts to an audience or through Create or update contacts in bulk. The type field currently accepts only static audiences.

Treść żądania

name
string
wymagane

Display name for the audience.

description
string

Longer description of who this audience is.

type
string

How the audience's recipients are determined. static is an explicit member list you manage by adding and removing contacts.

Possible values: static

Treść odpowiedzi

id
string
wymagane

ID of the audience, accepted by every operation that takes an audience_id.

name
string
wymagane

Display name for the audience.

description
nullable string

Longer description of who this audience is.

type
string
wymagane

How the audience's recipients are determined. static is an explicit member list you manage by adding and removing contacts.

Possible values: static

created_at
string
wymagane
updated_at
string
wymagane

Przejdź do dokumentacji, przewodników i przykładów dotyczących tego tematu.