Skip to main content
POST
Add multiple ColdSend native inboxes

Authorizations

X-API-Key
string
header
required

API key with format cs_live_xxx

Body

application/json

Request for bulk creating ColdSend native inboxes.

domain_id
string<uuid>
required

Domain ID where all inboxes will be created

inboxes
ColdSendInboxBulkItem · object[]
required

List of inboxes to create (max 100)

Required array length: 1 - 100 elements

Response

Bulk creation initiated successfully

Response for bulk ColdSend inbox creation.

This is an async operation. Inboxes are created via background tasks. The success_count, failed_count, and results fields will always be zero/empty in this response — poll the progress endpoint to get real-time results.

success
boolean
required
message
string
required
job_id
string<uuid>
required

Unique job ID for tracking creation progress

domain_id
string<uuid>
required

Domain ID

domain_name
string
required

Domain name

total
integer
required

Total inboxes in request

progress_url
string
required

URL to poll for creation progress

success_count
integer
default:0

Always 0 in initial response — poll progress endpoint for results

failed_count
integer
default:0

Always 0 in initial response — poll progress endpoint for results

skipped_count
integer
default:0

Always 0 in initial response — poll progress endpoint for results

results
ColdSendInboxBulkResult · object[]

Always empty in initial response — poll progress endpoint for per-inbox results