Create an audience
POST
/v1/audiencesconst audience = await bird.audiences.create({
name: "Newsletter subscribers",
});
console.log(audience.id); // "adn_…"audience = client.audiences.create(name="Newsletter subscribers")
print(audience.id, audience.name)audience, err := client.Audiences.Create(context.Background(), bird.AudienceCreateParams{
Name: "Newsletter subscribers",
})
if err != nil {
log.Fatal(err)
}
fmt.Println(audience.Id)$audience = $bird->audiences->create(
(new AudienceCreateRequest())->setName('Newsletter subscribers'),
);
echo $audience->getId(); // "adn_…"bird audiences create 'Newsletter subscribers' \
--description 'Contacts who opted into the monthly product newsletter'curl -X POST "https://us1.platform.bird.com/v1/audiences" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"name": "Newsletter subscribers",
"description": "Contacts who opted into the monthly product newsletter"
}'响应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.
请求载荷
namestring
必填
Display name for the audience.
descriptionstring
Longer description of who this audience is.
typestring
How the audience's recipients are determined. static is an explicit member list you manage by adding and removing contacts.
Possible values: static
响应载荷
idstring
必填
ID of the audience, accepted by every operation that takes an audience_id.
namestring
必填
Display name for the audience.
descriptionnullable string
Longer description of who this audience is.
typestring
必填
How the audience's recipients are determined. static is an explicit member list you manage by adding and removing contacts.
Possible values: static
created_atstring
必填
updated_atstring
必填