# Warmup

> Warm up new mailboxes so their emails land in the inbox, not in spam.

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/mailboxes/warmup

Warmup sends and answers a few emails a day from a mailbox and slowly raises the number, so inbox providers learn to trust it before your campaigns use it.

<DemoFrame guide="mailboxes-warmup" to="/integrations/{workspace}?tab=email" />

1. **⋮ on a mailbox → Email Warmup Settings.**
2. **Pick how hard** (conservative, normal, aggressive) and the daily target.
3. **Watch the Warmup column** grow toward the target.


---

## API — From your code

Source: /docs/engage/mailboxes/warmup/api

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

<Endpoints ops={["POST /admin/email-accounts/{id}/warmup/toggle", "PUT /admin/email-accounts/{id}/warmup/settings", "GET /admin/email-accounts/warmup/stats", "GET /admin/email-accounts/{id}/warmup/health", "GET /v3/warmup/status", "GET /v3/warmup/health", "POST /v3/warmup/enable", "POST /v3/warmup/disable", "PUT /v3/warmup/settings"]} />

<ApiPlayground
  ops={["POST /admin/email-accounts/{id}/warmup/toggle", "PUT /admin/email-accounts/{id}/warmup/settings", "GET /admin/email-accounts/warmup/stats", "GET /admin/email-accounts/{id}/warmup/health", "GET /v3/warmup/status", "GET /v3/warmup/health", "POST /v3/warmup/enable", "POST /v3/warmup/disable", "PUT /v3/warmup/settings"]}
  method="get"
  path="/admin/email-accounts/warmup/stats"
  tool="get_warmup_stats"
  args={`{
  "websiteId": "64b7f0a1c2d3e4f5a6b7c8d9"
}`}
/>

### Use case: Turn warmup on for a new mailbox [#use-case-turn-warmup-on-for-a-new-mailbox]

`POST /admin/email-accounts/{id}/warmup/toggle` with `{ "enabled": true }`, then `PUT …/warmup/settings` with `{ "intensity": "normal" }`.


---

## MCP — AI agents

Source: /docs/engage/mailboxes/warmup/mcp

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

<Tools names={["toggle_warmup", "get_warmup_stats", "update_warmup_settings", "get_warmup_health"]} />

### Use case [#use-case]

> How is warmup going on my mailboxes?

<McpToolCall name="get_warmup_stats">

```json
{
  "websiteId": "64b7f0a1c2d3e4f5a6b7c8d9"
}
```

</McpToolCall>