INinstantly
Account

Enable warmup for accounts

Changed on

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

  • Base URL
    https://api.instantly.ai
  • URL
    https://api.instantly.ai/api/v2/accounts/warmup/enable
  • Auth
    HTTP bearer

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": "01a19e6f-872b-722a-ac67-ef4847a54f73",
    "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' | 'journey-ai-build' | 'delete-leads' 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' | 'journey'

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": "01a19e6f-3f5d-7091-a533-39d9d99d54e7",
  "user_id": "01a19e6f-3f5d-7091-a533-39daa273da2b",
  "type": "move-leads",
  "entity_id": "01a19e6f-3f5d-7091-a533-39db73eee539",
  "entity_type": "list",
  "data": {
    "moved_lead_emails": [
      "jane@example.com",
      "john@example.com"
    ],
    "skipped_duplicate_emails": [
      "jane@example.com"
    ],
    "skipped_in_other_campaigns_emails": [
      "jane@example.com"
    ],
    "skipped_blocklisted_emails": [
      "jane@example.com"
    ]
  },
  "status": "pending",
  "created_at": "2026-11-02T22:44:13.277Z",
  "updated_at": "2026-11-02T22:44:13.277Z"
}

Changes

  • c781051105a8Revision changes
    • warning

      added the new delete-leads enum value to the response property for the response status

    • warning

      added the new journey enum value to the response property for the response status

    • warning

      added the new journey-ai-build enum value to the response property for the response status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status