Audiences
An audience is a named list of contacts. You build an audience once and reuse it, so reaching the same group again means naming the list rather than assembling the addresses every time. A contact can belong to many audiences, and you add or remove members as people join and leave. You manage audiences in the Email app, or with the bird CLI.
The Audiences page
The Audiences page (Email → Audiences) lists your audiences by name, type, and when they were created. Create one with a name and an optional description, then open it to see and manage its members. As with contacts, viewing needs the email_marketing read permission and managing needs write.
Members
Opening an audience shows its members, most recently added first, with each contact's email, name, and the date it joined.
There are two ways to add people:
- Add existing or new contacts by pasting email addresses on the audience, one per line, up to 1000 at a time. Bird matches each address to an existing contact or creates one, then assigns them all to the audience in a single step.
- Assign at import time by dropping contacts straight into an audience as you import or upsert them.
Removing a member takes the contact out of that audience only. The contact itself stays in your workspace and in any other audiences it belongs to. From the CLI the same operations are bird audiences add-contacts <audience-id> and bird audiences remove-contacts <audience-id>.
Sending to an audience
Sending one message to a whole audience is a broadcast, rather than listing the addresses yourself. Broadcasts are not yet available; to reach many recipients today, send a batch or fan out over single sends.
Next steps
- Contacts — the recipient records and typed properties an audience is built from
- Bulk sending — reaching many recipients today with batches
- Suppressions — the workspace list of addresses Bird will not deliver to