Skip to main content
POST
/
api
/
public
/
v1
/
sender-accounts
/
coldsend-native
Add ColdSend native inbox
curl --request POST \
  --url https://api.coldsend.pro/api/public/v1/sender-accounts/coldsend-native \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "domain_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "email_prefix": "<string>",
  "display_name": "<string>"
}
'
{
  "success": true,
  "message": "<string>",
  "inbox_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "email_address": "<string>",
  "display_name": "<string>",
  "domain_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "domain_name": "<string>",
  "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 create a ColdSend native inbox.

ColdSend native inboxes are created on domains managed by ColdSend infrastructure. They use Azure Communication Services for sending and Mailcow for receiving.

​
domain_id
string<uuid>
required

Domain ID where the inbox will be created. The domain must be verified and active in your workspace.

​
email_prefix
string
required

Email prefix (part before @, e.g., 'support', 'john', 'outreach')

Required string length: 1 - 64
​
display_name
string
required

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

Required string length: 1 - 255

Response

ColdSend inbox created successfully

Response for ColdSend inbox creation.

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

Created inbox ID

​
email_address
string
required

Full email address

​
display_name
string
required

Display name

​
domain_id
string<uuid>
required

Domain ID

​
domain_name
string
required

Domain name

​
overall_status
string
required

Inbox status

​
created_at
string<date-time>
required

Creation timestamp