Guides

# Warming Up Domains

Scale

Domain warmup warms all mailboxes on a domain simultaneously — ideal for large deployments where enabling warmup on each mailbox individually would be impractical. Available on the **Scale** plan.

Domain warmup requires the **Scale** plan. Lite plan accounts will receive a `403 Forbidden` response.

## Overview

Domain warmup is the recommended approach when you have multiple mailboxes on the same domain. Instead of enabling warmup one mailbox at a time, a single API call activates warmup across the entire domain using a configurable number of **units**.

1

Choose your unit count

Each unit = 2 warmup mailboxes, about 300 emails/day. Pick a unit count that matches your planned sending volume.

2

Call the enable endpoint

Mission Inbox provisions the warmup mailboxes and enrols them in our warmup network automatically.

3

Monitor via GET status

Track warmedDays and isWarmupActive to follow progress across the domain.

## How It Works

When you enable domain warmup, Mission Inbox creates dedicated warmup mailboxes on your domain (two per unit) and enrols them in **Mission Inbox’s own warmup network**. Those mailboxes then exchange real emails with a pool of trusted mailboxes daily, building domain-level sending reputation at scale.

Warmup mailboxes are provisioned automatically

You do not need to create mailboxes manually. Mission Inbox creates and manages them. The mailboxesCount field in the response tells you how many were activated.

Domain reputation benefits all mailboxes

Unlike mailbox warmup which builds reputation per address, domain warmup improves the trust score for the entire domain — all current and future mailboxes benefit.

Units control daily volume

Each unit represents 300 emails per day through the warmup network. Start with a unit count close to your intended production volume.

## Step 1 — Enable Domain Warmup

Call `POST /api/warmup/domains/:domainName` with `enabled: true` and your desired `unitCount`. Mission Inbox provisions the warmup mailboxes and enrols them in the warmup network automatically.

cURL

```bash
curl -X POST "https://api.v4.missioninbox.com/api/warmup/domains/yourdomain.com" \
  -H "X-Server-API-Key: miacme_4eC8vKmN2pQrStUwXyZaB6dEfGhIjLoPqRsT9uVwX1b" \
  -H "Content-Type: application/json" \
  -d '{
    "enabled": true,
    "unitCount": 2
  }'
```

Response

```json
{
  "message": "Domain warmup enabled successfully for yourdomain.com. 4 warmup mailbox(es) activated.",
  "stateChanged": true,
  "mailboxesWereCreated": true,
  "mailboxesCount": 4
}
```

`mailboxesWereCreated: true` means new warmup mailboxes were provisioned as part of this enable. `mailboxesCount` tells you how many are now active for this domain.

## Units

Domain warmup is sized in **units**. Each unit adds two warmup mailboxes to the domain and raises daily warmup volume.

Unit breakdown

1 unit

2 warmup mailboxes

300 emails / day

2 units

4 warmup mailboxes

600 emails / day

3 units

6 warmup mailboxes

900 emails / day

4 units

8 warmup mailboxes

1,200 emails / day

Once enabled, leave domain warmup running for the full cycle. Disabling mid-cycle resets momentum with receiving servers.

## Step 2 — Monitor Progress

Poll `GET /api/warmup/domains/:domainName` to track progress.` warmedDays` increments once per active day.

cURL

```bash
curl "https://api.v4.missioninbox.com/api/warmup/domains/yourdomain.com" \
  -H "X-Server-API-Key: miacme_4eC8vKmN2pQrStUwXyZaB6dEfGhIjLoPqRsT9uVwX1b"
```

Response

```json
{
  "domainId": "6a84bf23-825d-464f-8aa2-4ee218ecde93",
  "domainName": "yourdomain.com",
  "isVerified": true,
  "spfStatus": "OK",
  "dkimStatus": "OK",
  "mxStatus": "OK",
  "rpStatus": "OK",
  "dmarcStatus": "OK",
  "warmupStartDate": "2026-04-07T00:00:00.000Z",
  "warmedDays": 5,
  "totalWarmedDays": 5,
  "isWarmupActive": true,
  "customMxEnabled": false,
  "emailSent": 450,
  "mailboxCount": 5,
  "warmupMailboxes": [
    {
      "email": "john.doe@yourdomain.com",
      "firstName": "John",
      "lastName": "Doe",
      "mailboxNumber": 1,
      "createdAt": "2026-04-07T00:00:00.000Z",
      "updatedAt": "2026-04-12T08:00:00.000Z"
    }
  ],
  "createdAt": "2026-04-05T10:15:22.123Z",
  "updatedAt": "2026-04-12T08:30:45.456Z"
}
```

| Field           | Meaning                                                                           |
| --------------- | --------------------------------------------------------------------------------- |
| warmedDays      | Days warmed in the current active session.                                        |
| totalWarmedDays | Cumulative across all sessions.                                                   |
| isWarmupActive  | false means warmup is currently disabled.                                         |
| warmupMailboxes | The warmup mailboxes provisioned on this domain (two per unit).                   |
| mailboxCount    | Your own sending mailboxes on the domain — warmup mailboxes are not counted here. |

## Tips

Choose unitCount based on planned production volume

Pick a unit count that reflects the daily volume you intend to send in production. Too few units and the warmup signal will be weaker than your actual sending pattern.

Don't disable mid-cycle

Pausing resets the momentum built with receiving servers. Leave warmup running for the full cycle.

Production sending can run alongside warmup

You do not need to pause production email while domain warmup is active. Keep production volume reasonable relative to your current warmedDays stage.

[PreviousWarming Up Mailboxes](https://doc.v4.missioninbox.com/sales/guides/warmup.md)[NextDomain Sites](https://doc.v4.missioninbox.com/sales/guides/domain-sites.md)
