---
title: "Start email warmup"
method: POST
path: "/v3/user-api/warmup/start"
tags: ["Warmup"]
---

# Start email warmup

`POST /v3/user-api/warmup/start`

## Request

- Base URL: `https://api.nureply.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.nureply.com/v3/user-api/warmup/start`
- Auth: none declared. Required headers: `x-personal-api-key`

Start the warmup process for an email account to gradually build sender reputation.

**Warmup Process:**
- Gradually increases daily email volume using linear progression
- Starts with minimum volume and ramps up to maximum over stable days period
- Automatically manages inbox interactions to build positive reputation signals

**Prerequisites:**
- Account must be in "ready" state (both accountStatus and sendingStatus)
- Account must not be disabled
- DNS, SPF, and DMARC records must be properly configured

**Configuration:**
- `minimumWarmUpStartEmails`: Starting daily volume (default: 5, range: 1-10)
- `maximumWarmUpPerDay`: Target daily volume (default: 30, range: 10-90)
- `warmUpStableDays`: Days to reach maximum volume (default: 7, range: 5-30)

**Error Handling:**
- 400: Account not ready, invalid configuration, or DNS issues
- 404: Account not found or does not belong to you
- 409: Warmup already running for this account
- 429: Rate limit exceeded (max 5 requests per minute)

## Headers

- `x-personal-api-key` string, required

## Request body

- StartWarmupApiDto
  - `accountId` string, required: Email account ID to start warmup for
  - `minimumWarmUpStartEmails` number: Minimum number of warmup emails to start with per day
  - `maximumWarmUpPerDay` number: Maximum number of warmup emails per day at peak
  - `warmUpStableDays` number: Number of days to maintain stable volume after ramp-up

## Response `200`

- WarmupStartResponseDto
  - `message` string, required
  - `data` WarmupStartDataDto, required
    - `accountId` string, required: The MongoDB ObjectId of the email account
    - `address` string, required: The email address being warmed up
    - `warmUpId` string, required: Unique warmup session identifier
    - `isEnabled` boolean, required: Whether warmup is currently enabled
    - `warmUpStartDate` string, required: When the warmup process started (ISO 8601 format)
    - `minimumWarmUpStartEmails` number, required: Starting daily email volume
    - `maximumWarmUpPerDay` number, required: Target maximum daily email volume
    - `warmUpStableDays` number, required: Number of days to reach maximum volume

## Other responses

- `400`
- `404`
- `409`
- `429`

---

[API](https://skmtc.dev/nureply/apis/nureply-api.md) - [All operations](https://skmtc.dev/nureply/apis/nureply-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nureply/apis/nureply-api/revisions/a754b8b5eb0a?raw)