Skip to main content
POST
/
api
/
public
/
v1
/
sender-accounts
/
smtp
Add SMTP email account
curl --request POST \
  --url https://api.coldsend.pro/api/public/v1/sender-accounts/smtp \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "email_address": "<string>",
  "display_name": "<string>",
  "inbox_type": "<string>",
  "smtp_host": "<string>",
  "smtp_port": 32768,
  "smtp_username": "<string>",
  "smtp_password": "<string>",
  "imap_host": "<string>",
  "imap_port": 32768,
  "imap_username": "<string>",
  "imap_password": "<string>",
  "daily_limit": 100,
  "smtp_use_tls": true,
  "imap_use_ssl": true
}
'
{
  "success": true,
  "message": "<string>",
  "inbox_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "email_address": "<string>",
  "display_name": "<string>",
  "inbox_type": "<string>",
  "daily_limit": 123,
  "overall_status": "<string>",
  "created_at": "2023-11-07T05:31:56Z"
}

Authorizations

​
X-API-Key
string
header
required

API key with format cs_live_xxx

Body

application/json

Request to add an SMTP inbox (BYOC: Bring Your Own Credentials).

Connect your existing email account to ColdSend using SMTP/IMAP credentials. Supports Google Workspace, Outlook 365, and custom SMTP providers.

​
email_address
string
required

Full email address to connect (e.g., outreach@company.com)

Required string length: 5 - 255
​
display_name
string
required

Display name shown in recipient's inbox (e.g., 'John Smith from Company')

Required string length: 1 - 255
​
inbox_type
string
required

Email provider type: GOOGLE_WORKSPACE, OUTLOOK_365, or CUSTOM_SMTP

​
smtp_host
string
required

SMTP server hostname (e.g., smtp.gmail.com, smtp.office365.com)

Required string length: 1 - 255
​
smtp_port
integer
required

SMTP server port (587 for STARTTLS, 465 for SSL)

Required range: 1 <= x <= 65535
​
smtp_username
string
required

SMTP authentication username (usually your email address)

Required string length: 1 - 255
​
smtp_password
string
required

SMTP password or app-specific password (encrypted at rest)

Required string length: 1 - 500
​
imap_host
string
required

IMAP server hostname for reply monitoring

Required string length: 1 - 255
​
imap_port
integer
required

IMAP server port (993 for SSL)

Required range: 1 <= x <= 65535
​
imap_username
string
required

IMAP authentication username (usually your email address)

Required string length: 1 - 255
​
imap_password
string
required

IMAP password or app-specific password (encrypted at rest)

Required string length: 1 - 500
​
daily_limit
integer
default:100

Daily sending limit for this inbox. Recommended: 20-30 for new accounts, 50-80 for warming accounts.

Required range: x >= 1
​
smtp_use_tls
boolean
default:true

Enable TLS encryption for SMTP connection

​
imap_use_ssl
boolean
default:true

Enable SSL encryption for IMAP connection

Response

SMTP inbox created successfully

Response for SMTP inbox creation.

​
success
boolean
required
​
message
string
required
​
inbox_id
string<uuid>
required

Created inbox ID

​
email_address
string
required

Email address

​
display_name
string
required

Display name

​
inbox_type
string
required

Inbox provider type

​
daily_limit
integer
required

Daily send limit

​
overall_status
string
required

Inbox status

​
created_at
string<date-time>
required

Creation timestamp