> ## Documentation Index
> Fetch the complete documentation index at: https://openemail-docs.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Campaigns

> Send one email to one list, now or at a set time, once you approve it.

A campaign sends one email to one list. Your agent drafts it, you approve it in the Shopify admin, and it goes out at its set time.

**1. Have the email ready**

* Your agent writes the email, you check its preview, and a test lands in your inbox. See [Emails and preview](https://openemail-docs.mintlify.site/use/emails-and-preview.md).
* Campaign emails can't use `checkout`: only flow emails have a checkout to show.

> [!TIP]
>
> **Checkpoint:** the email's preview shows no errors.

**2. Draft the campaign**

* Your agent saves the draft: the email, the list (**All contacts** or one of your lists), and now or a set time in your store's time zone.
* Optional: a **recipient limit**, for example while your domain warms up. When more contacts qualify, the most engaged get it first.
* **Skip contacts emailed recently** is on by default: anyone handed an email in the last 16 hours, from a campaign or a flow, is skipped. Test emails don't count.

```text Ask your agent wrap theme={"dark"}
Draft a campaign that sends the Autumn sale email to the VIP list on Thursday at 9 am. Show me the recipient preview before you ask for approval.
```

> [!TIP]
>
> **Checkpoint:** the campaign shows on **Campaigns** as **Draft**.

**3. Preview the recipients**

* Your agent previews the campaign: how many would get it, a sample of ten, and how many are left out, each under one reason (**Complained**, **Bounced**, **Unsubscribed**, **Added to the do-not-email list by hand**, **Not subscribed**, **Over the recipient limit**).
* The preview also shows the maximum an approval would allow and a finish estimate under your sender's limits. A campaign that can't finish within 48 hours can't be approved: ask for a recipient limit.

```text Ask your agent wrap theme={"dark"}
Preview the Autumn sale campaign. How many get it, who is left out and why, and when will it finish?
```

> [!TIP]
>
> **Checkpoint:** the count is close to what you expected, and the left-out reasons make sense.

**4. Approve it**

* Your agent requests approval and gives you a link. Open it signed in to the Shopify admin. The page shows the counts, left-out contacts, sample recipients, the email at desktop and mobile widths, the schedule and the finish estimate.
* **Approve** schedules the campaign, or starts it if it's set for now. Your agent can't approve; only a person can. See [Approvals](https://openemail-docs.mintlify.site/use/approvals.md).
* The approval is refused while the email has errors, its images are still being copied, the finish estimate passes 48 hours, or the set time is more than 6 hours past.

> [!TIP]
>
> **Checkpoint:** the campaign reads **Scheduled**, or **Going out** if set for now.

**5. Watch it go out**

* Open the campaign from **Campaigns**. **Progress** counts messages **Accepted** by your sender, **Refused**, **Outcome unknown**, skipped (by reason), **Still queued** and **Cancelled**. While it goes out, the page updates every 5 seconds.
* **Accepted** means your sender took the message, not that it reached the inbox.
* **Left out at the start** shows who didn't get it, and why. **Finish estimate** shows when the last message should go.

```text Ask your agent wrap theme={"dark"}
How is the Autumn sale campaign doing? Show me accepted, refused, skipped and still queued.
```

> [!TIP]
>
> **Checkpoint:** **Still queued** falls and the state moves to **Sent**.

**6. Pause, resume or cancel**

* **Pause campaign** on the campaign's page stops new hand-offs; messages already in flight finish. **Resume campaign** carries on with no new approval. Your agent can do both.
* If OpenEmail paused the campaign itself (too many bounces or complaints, a refused email, or your sender stopping), **Why it paused** says so, and resuming needs a fresh approval: ask your agent to request one. See [A send is held](https://openemail-docs.mintlify.site/help/a-send-is-held.md).
* Cancelling is your agent's job, from any state before **Sent**. It's final: queued messages are cancelled and the campaign can't resume.

```text Ask your agent wrap theme={"dark"}
Pause the Autumn sale campaign.
```

> [!TIP]
>
> **Checkpoint:** the state reads **Paused** (or **Cancelled**), and Activity records who did it.

## How recipients are fixed at the start

Recipients are set when the campaign starts going out, not when you approve it. Until then, **Campaigns** shows **Not started** for its recipients.

* **Who gets it:** everyone on the list who qualifies at the start. Contacts who subscribe between approval and start get it; contacts who unsubscribe don't.
* **The approved maximum:** the count at approval plus 10%, or the recipient limit if that's lower. Past it, the most engaged contacts go first and the rest are left out as **Over the approved number**.
* **Checked again at hand-off:** each message re-checks consent and the do-not-email list just before it goes, so a late unsubscribe still counts.
* **A late start:** during a hold or a sender stop, a campaign waits and starts by itself, up to 6 hours past its set time. After that it goes back to **Draft** and you get a notice.
* **The 48-hour limit:** a campaign ends 48 hours after its first message, paused time included. Messages still waiting are cancelled, and it ends as **Sent**, with a note that it reached its time limit.

## Edits after approval

Renaming a campaign or lowering its recipient limit keeps the approval. Any other change sends it back to **Draft**, and your agent asks again: another email or a new version of it, another list, another set time, a raised or removed limit, contacts added to its list, or a change to the emailed-recently skip. Once it starts, only the name can change.

| State | What it means |
| - | - |
| **Draft** | Needs approval. A campaign waiting for approval is still a draft. |
| **Scheduled** | Approved, waiting for its start. |
| **Going out** | Recipients fixed; messages are being handed to your sender. |
| **Paused** | Remaining messages wait for a resume. |
| **Sent** | Every message has an outcome, or it reached its 48-hour limit. |
| **Cancelled** | Stopped for good. |

> [card] [Flows](https://openemail-docs.mintlify.site/use/flows.md)
>
> Emails that send themselves when a shopper leaves a checkout.

> [card] [Holds and sending limits](https://openemail-docs.mintlify.site/run/holds-and-sending-limits.md)
>
> What can hold a campaign, and how fast it goes out.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.