---
title: "Pause an account"
method: POST
path: "/api/v2/accounts/{email}/pause"
tags: ["Account"]
---

# Pause an account

`POST /api/v2/accounts/{email}/pause`

Requires one of the following scopes: `accounts:update`, `accounts:all`, `all:update`, `all:all`

## Path parameters

- `email` string, required

## Response `200`

The requested Account

- Account — An email account that can be used to send campaigns
  - `email` string, email, required — Email address of the account
  - `timestamp_created` string, date-time, required — Timestamp when the account was created
  - `timestamp_updated` string, date-time, required — Timestamp when the account was last updated
  - `first_name` string, required — First name associated with the account
  - `last_name` string, required — Last name associated with the account
  - `warmup` object — Warmup configuration for the account
    - `limit` number — Email sending limit for the account
    - `advanced` object — Advanced settings for the account
      - `warm_ctd` boolean — Whether the account is in warm CTD mode
      - `open_rate` number — Email open rate for the account
      - `important_rate` number — Important email rate for the account
      - `read_emulation` boolean — Whether read emulation is enabled
      - `spam_save_rate` number — Spam save rate for the account
      - `weekday_only` boolean — Whether to send emails only on weekdays
    - `warmup_custom_ftag` string — Custom tag for the account
    - `increment` 'disabled' | '0' | '1' | '2' | '3' | '4' — Daily increment added to the sending limit, starting from 0, until the full daily limit is reached (slow ramp). Gradually increases sending volume to improve deliverability. Set to `disabled` to send at the full daily limit from day one.
    - `reply_rate` number — Reply rate for the account
  - `added_by` string, uuid, nullable — User ID who added the account
  - `daily_limit` number, nullable — Daily email sending limit
  - `daily_limit_max` number, nullable — Maximum daily email sending limit for AirMail accounts
  - `warmup_limit_max` number, nullable — Maximum daily warmup sending limit for AirMail accounts
  - `modified_by` string, uuid, nullable — User ID who last modified the account
  - `tracking_domain_name` string, nullable — Tracking domain
  - `tracking_domain_status` string, nullable — Tracking domain status
  - `status` 1 | 2 | 3 | -1 | -2 | -3 — Current status of the account
  - `enable_slow_ramp` boolean, nullable — Whether to enable slow ramp up for sending limits
  - `inbox_placement_test_limit` number, nullable — The limit for inbox placement tests
  - `organization` string, uuid, required — Organization ID that owns this account
  - `warmup_status` 0 | 1 | -1 | -2 | -3, required — Current warmup status of the account
  - `status_message` object — Status message for the account
    - `code` string
    - `command` string
    - `response` string
    - `e_message` string
    - `responseCode` number
  - `timestamp_warmup_start` string, date-time, nullable — Timestamp when warmup was started
  - `provider_code` 1 | 2 | 3 | 4 | 8, required — Provider code for the account. Please make sure to specify the right provider code, otherwise your account will not work.
  - `setup_pending` boolean, required — Whether account setup is pending
  - `is_managed_account` boolean, required — Whether this is a managed account
  - `stat_warmup_score` number, nullable — Warmup score for the account
  - `sending_gap` number — The gap between emails sent from this account in minutes (minimum wait time when used with multiple campaigns)
  - `signature` string, nullable — Email signature for the account
  - `reply_to` string, email, nullable — Custom reply-to email address for the account
  - `autofix_failed` boolean, nullable — Whether automatic reconnection attempts have failed. null = in progress, true = failed, false = succeeded.

## Other responses

- `401` — This request is unauthorized (either the Authorization header is missing or invalid, or the API key has been revoked)
- `402` — This request cannot be fulfilled because the workspace does not have an active paid plan
- `404` — The requested resource was not found
- `429` — You have exceeded the rate limit. Please check the rate limit docs for more information.

---

[API](https://skmtc.net/instantly/apis/api-explorer.md) · [All operations](https://skmtc.net/instantly/apis/api-explorer/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/instantly/api-explorer/versions/378d1e253fe7/schema)