Warmup

Bulk-update warmup settings (async)

Applies the same warmup changes to many mailboxes at once. Returns 202 with a job id immediately — poll GET /jobs/{id} for progress. Mailboxes that can't be enabled (not connected) are recorded as per-item errors on the job. A strategy change updates both warmup_type and warmup_mode (the field the ramp reads) on every mailbox in the batch.

Required scope: warmup:write.

Requires a unique Idempotency-Key request header so retries never duplicate.

post/warmup/bulk-update

Request

  • Base URL: https://warmysender.com/api/v1
  • URL: https://warmysender.com/api/v1/warmup/bulk-update
  • Auth: HTTP bearer

Headers

Idempotency-Keystring required

A unique key (e.g. a UUID) that makes this write safe to retry. Reusing a key returns the original result; reusing it with a different body returns 409.

Request body

mailbox_idsstring[] required

Mailbox ids to update (1–500).

updatesobject required

A warmup settings object — same fields as Update warmup settings (warmup_enabled, warmup_type, warmup_target_daily_volume, language). At least one field required.

Response

Success

Changes

No recorded changes to this operation across all 1 revision of this API.