---
title: "Public Create Warmup Operation"
method: POST
path: "/warmup/operations"
tags: ["Warmup"]
---

# Public Create Warmup Operation

`POST /warmup/operations`

## Request

- Base URL: `https://public.outreach2day.com`
- URL: `https://public.outreach2day.com/warmup/operations`
- Auth: HTTP bearer

Warmup endpoint for POST /warmup/operations.

## Query parameters

- `workspaceId` integer, required

## Request body

- WarmupOperationCreateIn
  - `action` 'enable' | 'pause' | 'disable' | 'remove', required
  - `mailboxes` string[]
  - `target` union
    - MailboxExplicitTargetIn
      - `mode` 'explicit'
      - `mailboxIds` integer[]
      - `mailboxes` string[]
    - MailboxAllFilteredTargetIn
      - `mode` 'all_filtered'
      - `filters` MailboxInventoryFiltersIn
        - `search` string, nullable
        - `status` string[]
        - `warmupState` ClientWarmupState[]
        - `tagId` string[]
        - `domainId` integer[]
        - `sortBy` string, nullable
        - `sortDir` 'asc' | 'desc', nullable
      - `excludedMailboxIds` integer[]
      - `excludedMailboxes` string[]
  - `idempotencyKey` string, required

## Response `200`

Successful Response

- WarmupOperationOut
  - `operationId` string, required
  - `status` 'requested' | 'processing' | 'accepted' | 'completed' | 'partial' | 'failed' | 'failed_timeout' | 'needs_reconciliation', required
  - `action` 'enable' | 'pause' | 'disable' | 'remove', required
  - `workspaceId` integer, required
  - `requestedCount` integer, required
  - `prevalidatedCount` integer
  - `acceptedCount` integer, required
  - `rejectedCount` integer, required
  - `successCount` integer, required
  - `failureCount` integer, required
  - `rejections` WarmupRejection[]
    - `mailbox` string, required
    - `code` string, required
    - `message` string, required
  - `queuedAt` string, date-time, nullable
  - `startedAt` string, date-time, nullable
  - `completedAt` string, date-time, nullable
  - `items` WarmupOperationItemOut[]
    - `mailboxId` integer, required
    - `mailbox` string, required
    - `status` 'requested' | 'accepted' | 'processing' | 'ack_pending' | 'completed' | 'partial' | 'failed' | 'cancelled' | 'failed_timeout' | 'needs_reconciliation', required
    - `errorCode` string, nullable
    - `errorRef` string, nullable
    - `queuedAt` string, date-time, nullable
    - `startedAt` string, date-time, nullable
    - `completedAt` string, date-time, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/outreach2day/apis/outreach-today-public-api.md) · [All operations](https://skmtc.dev/outreach2day/apis/outreach-today-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/outreach2day/apis/outreach-today-public-api/revisions/0e5471143371?raw)