# Email campaigns

> Send email sequences to your leads from your own mailboxes, on the days and hours you choose.

Every section below does the same job: in the dashboard (Guide), from your code (API) or through an AI assistant (MCP).

## Guide — In the dashboard

Source: /docs/engage/email-campaigns

A campaign sends a sequence of emails to its contacts, from your connected mailboxes, inside the sending window you set.

<DemoFrame guide="engage-email-campaigns" to="/engage/{workspace}" />

1. **Engage → + New Campaign → Email Campaign.**
2. **Name it and set the window:** hours, days, timezone.
3. **Write the emails** under Sequences, add contacts, then switch it on.

### Every control on this screen [#every-control-on-this-screen]

Every button, field and switch, with what it does.

<ScreenControls screens={["engage", "engage-new", "campaign", "campaign-overview", "campaign-settings"]} />


---

## API — From your code

Source: /docs/engage/email-campaigns/api

Authenticated with `?privateKey=YOUR_KEY` (see [Authentication](/docs/authentication)).

<Endpoints ops={["GET /admin/email-campaigns", "POST /admin/email-campaigns", "GET /admin/email-campaigns/{id}", "PUT /admin/email-campaigns/{id}", "DELETE /admin/email-campaigns/{id}", "POST /admin/email-campaigns/clone"]} />

<ApiPlayground
  ops={["GET /admin/email-campaigns", "POST /admin/email-campaigns", "GET /admin/email-campaigns/{id}", "PUT /admin/email-campaigns/{id}", "DELETE /admin/email-campaigns/{id}", "POST /admin/email-campaigns/clone"]}
  method="get"
  path="/admin/email-campaigns"
  tool="list_campaigns"
  args={`{
  "websiteId": "64b7f0a1c2d3e4f5a6b7c8d9"
}`}
/>

### Use case: Pause a campaign [#use-case-pause-a-campaign]

`PUT /admin/email-campaigns/{id}` with `{ "status": "paused" }`; `"active"` starts it again.


---

## MCP — AI agents

Source: /docs/engage/email-campaigns/mcp

Connect the [MCP server](/docs/mcp#quickstart), then just ask.

<Tools names={["list_campaigns", "create_campaign", "get_campaign", "update_campaign", "clone_campaign", "delete_campaign"]} />

### Use case [#use-case]

> Create a 3-email campaign for website visitors who saw our pricing page.

<McpToolCall name="create_campaign">

```json
{
  "websiteId": "64b7f0a1c2d3e4f5a6b7c8d9",
  "name": "Pricing page visitors",
  "emailAccountId": "6530c1d2e3f4a5b6c7d8e9f6",
  "steps": [
    {
      "subject": "Saw you checking our pricing",
      "body": "Hi {{ first_name | there }},\nQuick question about pricing\u2026\n{{sender_signature}}\n{{unsubscribe_text}}",
      "delayDays": 0
    }
  ]
}
```

</McpToolCall>

