Sign in

v1

latestOpenAPI 3.1.02026-07-2617125852.3 KB
Account

Enable warmup for accounts

Initiates a background job to enable warmup for the specified accounts. The response will contain the initial background job object. You can monitor the job's progress by polling the GET: /api/v2/background-jobs/:id endpoint.

post/api/v2/accounts/warmup/enable

Request body

emailsstring[]

List of emails to enable warmup accounts for. The emails should be attached to accounts in your workspace.

include_all_emailsboolean

If true, it will enable warmup to all accounts

excluded_emailsstring[]

List of emails to exclude when include_all_emails is true.

searchstring

Optional search query to filter accounts when include_all_emails is true.

Example request

{
  "emails": [
    "user@example.com"
  ],
  "include_all_emails": true,
  "excluded_emails": [
    "user@example.com"
  ],
  "filter": {
    "tag_id": "019f94cd-ad94-7b8f-989b-5ba89ecbf85a",
    "filter": "ACC_FILTER_PAUSED"
  },
  "search": "gmail.com"
}

Response

The requested Background Job

idstring required

Unique identifier for the background job

workspace_idstring uuid required

Workspace ID

user_idstring uuid nullable

The id of the user that triggered the action that created the job

type'move-leads' | 'import-leads' | 'export-leads' | 'update-warmup-accounts' | 'rename-variable' | 'broadcast-ai-generate' | 'broadcast-website-scrape' | 'import-subscribers-from-crm' | 'resync-subscriber-crm-tags' required

Type of background job

entity_idstring uuid nullable

The id of the entity that the job is related to

entity_type'list' | 'campaign' | 'workspace' | 'broadcast' | 'subscriber-group-sync' | 'subscriber-group'

Type of entity

progressnumber required

Progress of the job as a percentage (from 0 to 100)

status'pending' | 'in-progress' | 'success' | 'failed' | 'draining' | 'paused' | 'cancelled' required

Job status

created_atstring required

Timestamp when the job was created

updated_atstring required

Timestamp when the job was last updated

Example response

{
  "id": "675266e304a8e55b17f0228b",
  "workspace_id": "019f94cd-83be-78a1-8302-7d0e7112d2ad",
  "user_id": "019f94cd-83be-78a1-8302-7d0f5fbd1ead",
  "type": "move-leads",
  "entity_id": "019f94cd-83be-78a1-8302-7d1079f61d26",
  "entity_type": "list",
  "data": {
    "moved_lead_emails": [
      "jane@example.com",
      "john@example.com"
    ]
  },
  "status": "pending",
  "created_at": "2026-07-24T15:45:24.414Z",
  "updated_at": "2026-07-24T15:45:24.414Z"
}