Add Warmup to Mailbox

POST

/mailboxes/warmup

Enrolls an existing mailbox in the warmup program to gradually build sender reputation.

Once enrolled, the mailbox begins sending and receiving automated warmup emails on a scheduled ramp-up. The initial warmup status is ACTIVE.

After enrollment, warmup analytics (warmupEmailSentCount, landedOnSpamCount, landedOnInboxCount, healthScore) are returned via GET /mailboxes/mailbox inside the warmupDetails object.

Note: The warmup program incurs an additional charge, prorated from the enrollment date to the next billing cycle.

Request

Authorization

API Key

Add parameter in header

cmr-x-api-key

Example:

cmr-x-api-key: ********************

Query Params

Responses

🟢200Success

application/json

Warmup enabled

Bodyapplication/json

🟠401Unauthorized

🟠400Bad Request

🟠422Unprocessable Entity

🟠404Not Found

🟠402Payment Required

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://customers.coldmailreseller.com/api/v1/integration/mailboxes/warmup?mailboxId=GP6M2J2DHXM3F2J40S8AP316R2QR' \
--header 'cmr-x-api-key: <api-key>'

Response Example

200 - Example 1

{
    "status": 200,
    "message": "Warmup enabled",
    "data": null
}

Modified at 2026-09-10 05:36:40

Delete Mailbox

Toggle Warmup