---
title: "Enable warming"
method: POST
path: "/v1/warming/enable"
tags: ["Warming"]
---

# Enable warming

`POST /v1/warming/enable`

## Request

- Base URL: `https://api.winnr.app`
- URL: `https://api.winnr.app/v1/warming/enable`
- Auth: HTTP bearer

Enable warming for one or more email users. Creates campaigns and starts warmup.
Warming is billed at enable time ($0.60/mailbox/month): newly enabled mailboxes
are charged a full month upfront and added to the recurring warming line item.
Amounts already paid for mailboxes that never activated are credited
automatically, so retries are not double-charged.

## Request body

- object
  - `user_ids` string[], required
  - `settings` object
    - `emails_per_day` integer
    - `response_rate` integer
    - `rampup_enabled` boolean
    - `rampup_speed` 'slow' | 'normal' | 'fast'

## Response `200`

Warming enabled

- object
  - `meta` Meta
    - `request_id` string
    - `timestamp` string, date-time
  - `data` object
    - `enabled` WarmingMailbox[]
      - `id` string
      - `full_address` string
      - `domain_string` string
      - `name` string
      - `warming_status` 'active' | 'paused' | 'connecting' | 'connection_problem' | 'disabled'
      - `warming_credentials_stale` boolean: True while warming may still hold an old mailbox password (after a password change, until it is passed on). Reconnect clears it.
      - `warming_emails_per_day` integer
      - `warming_response_rate` integer
      - `warming_rampup_enabled` boolean
      - `warming_rampup_speed` 'slow' | 'normal' | 'fast'
      - `warming_health_score` number
      - `warming_inbox_rate` number
      - `warming_spam_rate` number
      - `warming_total_sent` integer
      - `warming_total_replies` integer
      - `warming_started_at` string, date-time, nullable
      - `warming_last_sync` string, date-time, nullable

## Other responses

- `402`: Payment for the newly enabled mailboxes failed. Nothing was enabled.

---

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