Create an audience
/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"
}'{
"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.
Request Payload
nameDisplay name for the audience.
descriptionLonger description of who this audience is.
typeHow the audience's recipients are determined. static is an explicit member list you manage by adding and removing contacts.
Possible values: static
Response Payload
idID of the audience, accepted by every operation that takes an audience_id.
nameDisplay name for the audience.
descriptionLonger description of who this audience is.
typeHow the audience's recipients are determined. static is an explicit member list you manage by adding and removing contacts.
Possible values: static
created_atupdated_atRelated resources
Continue with the documentation, guides and examples for this topic.