Warmup

A brand-new mailbox sending real volume immediately is the most common cause of landing in spam. Warmup ramps a mailbox up gradually with real send/reply/open activity before you point cold-email volume at it.

Method	Path	Description
`POST`	`/v1/api/warmup/list`	List warmup subscriptions
`GET`	`/v1/api/warmup/details`	Get one subscription’s details
`POST`	`/v1/api/warmup/add`	Start warmup on mailbox(es)
`POST`	`/v1/api/warmup/pause`	Pause warmup
`POST`	`/v1/api/warmup/resume`	Resume paused warmup
`POST`	`/v1/api/warmup/cancel`	Cancel warmup
`GET`	`/v1/api/warmup/stats`	Get warmup statistics (volume, inbox rate, etc.)
`GET`	`/v1/api/warmup/pricing`	Get current warmup pricing

Start warmup


curl -X POST https://api.infrabox.software/v1/api/warmup/add \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-Workspace-Id: YOUR_WORKSPACE_UID" \
  -H "Content-Type: application/json" \
  -d '{ "mailbox_uids": ["mb_111", "mb_222"] }'

Warmup is billed separately from mailbox provisioning — check /v1/api/warmup/pricing before enabling it on a large batch.

Errors

Status	Meaning
`400`	Invalid body
`401`	Missing/invalid API key
`404`	Mailbox or subscription not found
`500`	Internal error