# Campaigns {#campaigns}


A campaign is a one-time email or SMS send to an explicit audience. Each campaign uses a template and tracks delivery metrics (opens, clicks, bounces, unsubscribes).


## Campaign vs Flow {#campaign-vs-flow}


- **Campaign** — manual, one-time send to selected lists, a segment, or All Contacts. Good for newsletters, announcements, promotions.
- **Flow** — automated, event-triggered sequence. Good for welcome series, onboarding, re-engagement.


## Audiences {#audiences}


Campaigns do not fall back to everyone when no audience is selected. Choose one audience type:

- **Contact lists** — send to one or more lists, optionally filtered by a segment.
- **Segment** — send to contacts matching a saved segment.
- **All Contacts** — send to every subscribed contact in the brand.

All Contacts is a deliberate target. The dashboard shows it as a pinned audience option and asks for confirmation before delivery. MCP/API users must also confirm an all-contacts launch with `confirm_send_to_all`.


## Scheduling {#scheduling}


Campaigns can be sent immediately or scheduled for a future date and time.


## Edit lock and lifecycle {#edit-lock-and-lifecycle}


Once a campaign is sent, its content is locked. The API response includes an `editable: boolean` field and the dashboard renders a banner reflecting the current lifecycle:

| Status | Editable | What you can do |
| --- | --- | --- |
| `draft` | yes | Full edit access. |
| `scheduled` | yes, until 5 minutes before send | A countdown banner appears 15 minutes before the lock time. |
| `scheduled` (final 5 min) | no | Cancel or duplicate. |
| `live` | no | Wait for completion. |
| `paused` | no | Resume sends the original to remaining contacts. Cancel + Duplicate if you want to change direction. |
| `completed` / `cancelled` / `archived` | no | Duplicate to iterate. |

**Name is always editable.** The name is internal metadata (list/search reference), never delivered content. Renaming a sent campaign succeeds on every status.

**Status transitions are always allowed.** Resume, Cancel, and other lifecycle operations are not content edits and are not blocked by the lock.

When a locked campaign receives content edits (trigger, template, channel, scheduled_at), the API returns:

```json
{
  "code": 422,
  "error": true,
  "error_code": "campaign_locked",
  "message": "This campaign has been sent and can't be changed.",
  "status": "completed",
  "hint": "Duplicate it to create a new draft."
}
```


## Testing subject lines {#testing-subject-lines}


Subject line tests are in beta and not yet on for every account. A send to 1,000 people or more can carry up to six subject lines: yours and NitroLLM's suggested alternatives, edited or not, or lines you write. Everyone can get one at random, or a test part of the list can, with the winning line going to the rest. See [Test subject lines](https://docs.nitrosend.com/guides/creating-campaigns.md#test-subject-lines).


## Duplicating a sent campaign {#duplicating-a-sent-campaign}


`POST /v1/my/campaigns/{id}/duplicate` returns a fresh draft that copies the source's audience (trigger.audience_type, contact_list_ids, segment_id) and template content (design, subject, preheader, body, from_name, from_email, reply_to). It does **not** copy schedule, approval, send history, or metrics — the new campaign starts clean with `status: draft`, `approval_state: pending_review`, and name `"Copy of {original}"`.

Duplicate works on any status, locked or not. In the dashboard, the banner on locked campaigns shows **Edit as new campaign** as the primary CTA, and the overflow menu on every campaign row exposes the same action.
