---
title: "Update a sender email's warm-up settings"
method: PUT
path: "/sender-emails/{id}/warmup"
tags: ["Sender Emails"]
---

# Update a sender email's warm-up settings

`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

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.

## Path parameters

- `id` integer, required

## Request body

- ModelsUpdateSenderEmailWarmupRequest
  - `capLimit` integer: CapLimit is the most warm-up emails a day; the ramp stops here.
  - `enableReplies` boolean: EnableReplies lets warm-up recipients reply, adding reply signals.
  - `enabled` boolean: Enabled switches warm-up on (true) or off (false). A mailbox that has never been enrolled needs enabled: true to take any other setting.
  - `increaseBy` integer: IncreaseBy is how many warm-up emails are added each day until CapLimit.
  - `startLimit` integer: StartLimit is how many warm-up emails go out on the first day.
  - `timezone` string: Timezone is the IANA timezone the warm-up send window runs in.
  - `weekdaysOnly` boolean: WeekdaysOnly limits warm-up sending to Monday through Friday.

## Response `200`

Warm-up settings after the change

- ModelsSenderEmailWarmupSettingsResponse
  - `activatedAt` string: ActivatedAt is when warm-up was first switched on; the ramp counts days from here. Null until then.
  - `capLimit` integer: CapLimit is the most warm-up emails a day; the ramp stops here.
  - `configured` boolean: 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.
  - `currentPerDay` integer: 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.
  - `enableReplies` boolean: EnableReplies lets warm-up recipients reply, adding reply signals.
  - `enabled` boolean: Enabled is true while the mailbox is warming.
  - `healthScore` integer: 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.
  - `increaseBy` integer: IncreaseBy is how many warm-up emails are added each day until CapLimit.
  - `senderEmailId` integer
  - `startLimit` integer: StartLimit is how many warm-up emails go out on the first day.
  - `timezone` string: Timezone is the IANA timezone the warm-up send window runs in.
  - `weekdaysOnly` boolean: WeekdaysOnly limits warm-up sending to Monday through Friday.

## Other responses

- `400`: Invalid sender email ID, request body or warm-up settings
- `401`: Unauthorized - invalid or missing API key
- `404`: Sender email not found
- `409`: Warm-up is off for this mailbox and the request does not switch it on, or the mailbox is disconnected
- `500`: Failed to update warm-up settings

---

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