Sender Emails

Update a sender email's warm-up settings

Switches warm-up on or off and changes the warm-up ramp. Only the fields provided change. Warm-up sends startLimit emails on the first day and adds increaseBy each day until it reaches capLimit a day; this volume is separate from the campaign sending limits on the sender email. Switching warm-up on for a mailbox that has never been enrolled enrols it with the defaults (2 a day, 2 more each day, up to 10 a day, weekdays only, UTC) overridden by any fields sent, and the ramp starts today; the mailbox must be connected. A mailbox that has never been enrolled needs enabled: true in the same request to take any other setting. Switching warm-up off keeps the settings and stops a reconnect from switching it back on. Raising capLimit on a mailbox that is already warming takes effect from the next scheduling run without restarting the ramp.

put/sender-emails/{id}/warmup

Request

  • Base URL: https://api.emailchaser.com/r
  • URL: https://api.emailchaser.com/r/sender-emails/{id}/warmup
  • Auth: HTTP bearer

Path parameters

idinteger required

Sender Email ID

Request body

capLimitinteger

CapLimit is the most warm-up emails a day; the ramp stops here.

enableRepliesboolean

EnableReplies lets warm-up recipients reply, adding reply signals.

enabledboolean

Enabled switches warm-up on (true) or off (false). A mailbox that has never been enrolled needs enabled: true to take any other setting.

increaseByinteger

IncreaseBy is how many warm-up emails are added each day until CapLimit.

startLimitinteger

StartLimit is how many warm-up emails go out on the first day.

timezonestring

Timezone is the IANA timezone the warm-up send window runs in.

weekdaysOnlyboolean

WeekdaysOnly limits warm-up sending to Monday through Friday.

Example request

{
  "capLimit": 40,
  "enabled": true,
  "increaseBy": 2,
  "startLimit": 2,
  "timezone": "America/New_York",
  "weekdaysOnly": true
}

Response

Warm-up settings after the change

activatedAtstring

ActivatedAt is when warm-up was first switched on; the ramp counts days from here. Null until then.

capLimitinteger

CapLimit is the most warm-up emails a day; the ramp stops here.

configuredboolean

Configured is true once the mailbox has warm-up settings of its own. While false the mailbox has never been enrolled, and the values below are the defaults that switching warm-up on would use.

currentPerDayinteger

CurrentPerDay is today's ramp target, 0 while warm-up is off. On a weekend a weekdays-only mailbox still shows its ramp value, although no warm-up emails send that day.

enableRepliesboolean

EnableReplies lets warm-up recipients reply, adding reply signals.

enabledboolean

Enabled is true while the mailbox is warming.

healthScoreinteger

Health score 0-100, higher is better: the share of this account's warm-up emails over the last 7 full days that landed in the inbox rather than spam; 90+ is the app's bar for campaigns. It moves daily as warm-up emails land in the inbox (up) or in spam (down). Null while warm-up is off or before 20 warm-up emails were checked.

increaseByinteger

IncreaseBy is how many warm-up emails are added each day until CapLimit.

senderEmailIdinteger
startLimitinteger

StartLimit is how many warm-up emails go out on the first day.

timezonestring

Timezone is the IANA timezone the warm-up send window runs in.

weekdaysOnlyboolean

WeekdaysOnly limits warm-up sending to Monday through Friday.

Example response

{
  "activatedAt": "2026-09-10T12:00:00Z",
  "capLimit": 40,
  "configured": true,
  "currentPerDay": 6,
  "enabled": true,
  "healthScore": 96,
  "increaseBy": 2,
  "senderEmailId": 123,
  "startLimit": 2,
  "timezone": "UTC",
  "weekdaysOnly": true
}

Changes

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