# Campaigns

Create and send targeted email campaigns to your audience.

Campaigns are the core of SendBeam. A campaign is a single email broadcast sent to one or more
recipients — whether that's your entire audience, a specific list, or a filtered segment. You
compose the email once and SendBeam delivers it reliably through its managed delivery, tracking
every open, click, bounce, and unsubscribe automatically.

## What is a Campaign?

A campaign bundles together everything needed to send an email blast: a subject line, a from
address, the email content, and the chosen audience. Once you hit send (or schedule it),
SendBeam queues the messages and updates the campaign status in real time as
delivery progresses.

Each campaign stores its own independent statistics, so you can compare performance across
broadcasts without any data bleeding between sends.

> Campaigns are one-time broadcasts. If you need to send a series of automated emails triggered
> by subscriber behaviour, see [Automations](https://sendbeam.io/docs/automations) instead.
> 

## Campaign Statuses

Every campaign moves through a set of statuses that reflect where it is in its lifecycle:

- **Draft** — The campaign has been created but not yet sent or scheduled. You can
  freely edit all settings, swap out content, and change the recipient list.
- **Scheduled** — A future send date and time has been set. You can still edit the
  campaign or cancel the send before that time.
- **Sending** — Messages are actively being queued and dispatched.
  This status typically lasts seconds to a few minutes depending on audience size.
- **Sent** — All messages have been handed off for delivery. Statistics
  will continue to update as recipients open emails and click links, but the campaign itself
  cannot be resent or modified.
- **Cancelled** — A scheduled campaign that was cancelled before it sent, or that
  could not send when its time came (for example because the audience was empty, the monthly
  email allowance was used up, or sending was paused). In that case the reason is shown on the
  campaign page and admins are emailed. Duplicate it to try again.

> There is no undo for a sent campaign. Once the status changes to **Sent**, the
> emails are already in transit. Always send yourself a test email and preview the campaign
> before confirming the send.
> 

## Campaign Types

When setting up a campaign you choose who receives it. SendBeam supports three recipient modes:

- **All contacts** — Every subscribed contact in the workspace receives the email.
  Useful for workspace-wide announcements or newsletters.
- **Specific list** — Only contacts who are members of a chosen [list](https://sendbeam.io/docs/lists)
  receive the campaign. Ideal for targeting subscribers who opted in through a particular form or
  import.
- **Segment** — Only contacts who match a saved [segment](https://sendbeam.io/docs/segments)
  receive the campaign. Use this for behaviour-based or attribute-based targeting, such as
  contacts who haven't opened in 90 days, or contacts in a specific country.

> Segments are evaluated at send time, not when you create the campaign. This means a segment
> can grow or shrink between the moment you schedule a campaign and when it actually sends —
> which is usually the behaviour you want.
> 

## Deleting a Campaign

A draft or cancelled campaign has a **Delete** button on its page (and
`DELETE /api/v1/campaigns/{id}` in the API). Sent campaigns cannot be deleted: their
statistics, their web version and the links in recipients' inboxes are a record you keep. Cancel a
scheduled campaign first if you want it gone.

A campaign's own **from name** and **from email** are used when the address is one
this workspace may send as — a verified sending domain or the workspace's shared address. Otherwise the
workspace's sender details are used, so an old draft with a stale address still goes out.

## The Campaign Workflow

A typical campaign follows these stages from idea to inbox:

1. **Create** — Give the campaign a name, subject line, and from address. Choose
  your audience (all contacts, list, or segment).
2. **Design** — Build the email body in the Visual builder, the rich-text editor,
  or the HTML view for full control.
3. **Personalise** — Insert merge tags such as `{'{{first_name}}'}` to
  address each subscriber individually.
4. **Preview & test** — Use the mobile/desktop preview, then send a test email
  to yourself from the campaign page before committing.
5. **Send or schedule** — Click **Send Now** to dispatch immediately,
  or pick a date and time to schedule the send for later.
6. **Review statistics** — Once sent, track opens, clicks, bounces, and
  unsubscribes from the campaign's stats dashboard.

---
Source: https://sendbeam.io/docs/campaigns