POST /accounts

Authentication

Send your organization API key as a Bearer credential.

Authorization: Bearer YOUR_API_KEY

Body

application/json

Account data required to create a new email account.

first_name string required

First name of the account owner

Example: John
last_name string required

Last name of the account owner

Example: Doe
email string required

Email address of the account

Example: john.doe@example.com
imap_password string required

IMAP password for the email account

Example: imap-secret-password
smtp_password string required

SMTP password for the email account

Example: smtp-secret-password
smtp_host string required

SMTP host (e.g., smtp.gmail.com)

Example: smtp.gmail.com
smtp_port number required

SMTP port (default: 465)

Example: 465
imap_host string required

IMAP host (e.g., imap.gmail.com)

Example: imap.gmail.com
imap_port number required

IMAP port (default: 993)

Example: 993
cooldown_start number

Cooldown start period in seconds (default: 180)

Example: 180
cooldown_end number

Cooldown end period in seconds (default: 360)

Example: 360
signature string

Email signature text

Example: Best regards, John Doe
daily_limit number

Daily sending limit (default: 50)

Example: 50
warmup any

Warmup configuration object

Example: {"enable":false,"limit":20,"start":1}
provider_code number required

Email provider code (1=Google, 2=Yandex, 3=Mailru/VK, 4=Custom IMAP/SMTP)

Allowed values: 1, 2, 3, 4

Example: 4

Response

application/json

Account successfully created

id number required

ID of the account

Example: 1
email string required

Email of the account

Example: user@example.com
first_name string required

First name

Example: John
last_name string required

Last name

Example: Doe
warmup boolean required

Whether warmup is enabled

Example: true
warmup_last_date_send string required

Last date when warmup sent an email

Example: 2025-09-20T12:00:00.000Z
last_type_send_email string required

Type of last sent email

Example: warmup
warmup_start_date string required

Date when warmup started

Example: 2025-09-10T10:00:00.000Z
warmup_sent_today number required

Number of warmup emails sent today

Example: 5
warmup_daily_limit number required

Warmup daily limit

Example: 20
warmup_starting_email_number number required

Warmup starting email number

Example: 1
expected_to_send_warmup_emails number required

Expected to send warmup emails

Example: 50
service string required

Service (google, yandex, etc.)

Example: google
limit number required

Sending limit per day

Example: 50
sent_today number required

Sent today

Example: 10
total_sent number required

Total sent emails

Example: 300
id_previous_sending_campaign number required

ID of previous sending campaign

Example: 123
cooldown_start number required

Cooldown start (seconds)

Example: 180
cooldown_end number required

Cooldown end (seconds)

Example: 360
is_account_ready string required

Date when account is ready

Example: 2025-09-18T09:00:00.000Z
user_id number required

User ID owning the account

Example: 42
tags string[] required

Tags assigned to account

Example: ["Disconnected", "Bounce"]
last_block_account_date string required

Date when account was last blocked

Example: 2025-09-21T14:00:00.000Z
error_text string required

Error text if account failed to connect

Example: Invalid credentials
signature string required

Signature attached to outgoing emails

Example: Best regards, John