Broadcasts

One broadcast. Your choice of workflow.

Create a campaign draft, target an audience, then review and schedule the send from the dashboard, CLI or MCP. Connect campaign reporting to your application workflow. Use the dashboard, API, CLI or MCP to work with the same broadcast.

Create a broadcast Read the broadcasts guide

Create your account, then draft a broadcast in the dashboard or through the API.

Set up in:

CursorCopied!

September newsletter

Example campaign

Choose who hears from you.

Selected audience

Newsletter subscribers

Example contacts

12,000

Keep contacts together in an audience and review the eligible recipients before sending.

Explore a campaign workflow with example content and data.

Campaigns, with a transactional API's discipline.

Broadcasts are marketing email on the Bird Email API, the same network that carries your transactional mail. You target a single audience, schedule with an explicit timestamp, and cancel a send mid-flight if you have to. One targeting concept, no juggling lists and segments.

Five things a broadcast does.

Draft, target, schedule, cancel, measure.

01
Draft-first lifecycle.
Create a broadcast as a draft, refine the content, and send it when you're ready.
02
Audience targeting.
Point a broadcast at a single audience. One targeting field, no stacking lists and segments to reason about.
03
Send now or schedule.
Send now or schedule a campaign up to a year ahead in the dashboard. Review the audience, published content and sender before committing.
04
Cancel mid-flight.
Cancel a scheduled or sending broadcast to stop recipients it has not reached. Mail already on its way cannot be recalled.
05
Per-broadcast analytics.
Delivery and engagement metrics for each broadcast, alongside the rest of your email analytics.

Prepare your first broadcast.

Use the dashboard or API to create the same draft, then review the audience and sender.

Create a broadcast

Create a draft before you commit to a send.

Create a draft with your verified sender, audience and published template. Review its content and recipients in your workspace before choosing to schedule or send. Replace the example values below with your own; this command does not send the campaign.

broadcast.sh

draft

# Create a draft using your verified sender, audience and published template.
# Replace these example values with IDs from your workspace.
bird email broadcasts create \
  --from "Acme News <newsletter@acme.com>" \
  --audience-id adn_01krdgeqcxet5s7t44vh8rt9mg \
  --template emt_01krdgeqcxet5s7t44vh8rt9mg \
  --tag campaign=product-launch

# Review the draft in your workspace before scheduling or sending it.

Targeting that respects consent.

A broadcast targets one audience, and Bird applies your marketing suppressions before it sends. Recipient suppressions and opt-out preferences are checked when sending starts. Keep your audience based on consent, and review the deliverable count before scheduling.

Works with the rest of Email.

Build the list you target on the audiences page, send transactional mail through the same send API, and watch results in email analytics.

The interface changes. The campaign stays together.

A broadcast is a saved campaign with an audience, sender, content and delivery state. Start it in the dashboard, update the draft through the API or ask an agent to prepare it through MCP. The same campaign is available for your team to review and schedule.

Prepare your next campaign

Create campaigns in the dashboardWrite and review a newsletter with your team.Use the Broadcasts APIIntegrate the campaign lifecycle with your application.Let an agent prepare the workUse MCP to create a draft, inspect content and read campaign results.Email guides and answersContinue with the documentation, learning videos and FAQs.Broadcasts guideFollow the documented campaign lifecycle and check the current access requirements.Email pricingReview published rates for your expected campaign volume.

Put it into practice.

Continue with the documentation, guides and examples for this topic. Resources are in English.

Watch the guideEmail broadcasts: one email to your whole audience Follow the learning pathBuild your first integration

Get an implementation brief

Questions about broadcasts

How do I target a broadcast?

Choose one saved audience. Bird resolves its current members when sending begins and applies the relevant suppressions and preferences. A template personalizes the message using each recipient’s registered contact properties.

Can I schedule or cancel a broadcast?

Yes. The dashboard supports sending now or scheduling up to a year ahead, with editing and rescheduling before sending starts. Cancel a scheduled or sending broadcast to stop recipients it has not reached; messages already on their way cannot be recalled.

Is this the same as scheduling a transactional message?

They have different contracts. Broadcasts schedule a campaign for an audience. The messages API schedules inline content from 30 seconds to 30 days ahead and cannot combine scheduled_at with a stored template.

Can I rehearse without mailing my customers?

Create a separate audience containing only documented sandbox addresses. The simulated outcomes exercise delivery events and webhooks without external delivery. Sandbox traffic still uses sending allowance and appears in metrics.

Build the campaign around your audience

AudiencesYour contacts and the audiences you target from a broadcast.TemplatesStored, versioned email templates, personalized per recipient at send.AnalyticsDelivery by domain, provider and IP, with separate engagement breakdowns.Email API overviewThe full Email API: sending, deliverability, IPs, suppression, analytics, and broadcasts.

Put your next campaign into a repeatable workflow.

Create a draft in your workspace, or discuss campaign automation and integration with our email team.

Create a broadcast Discuss campaign integration