Skip to main content
POST
Send a direct email to a contact

Authorizations

X-API-Key
string
header
required

API key with format cs_live_xxx

Path Parameters

contact_id
string<uuid>
required

Body

application/json

Compose and send a personal 1:1 email straight to a contact.

No campaign is involved: the send is anchored to a campaign-less external lead so the reply threads into unibox out-of-band. body_text or body_html must be provided (the service derives one from the other when only HTML is sent). Attachments reuse the reply pipeline's base64 -> GCS path.

inbox_id
string<uuid>
required

Team inbox to send from (must be ACTIVE)

subject
string
required

Email subject

Maximum string length: 500
body_text
string | null

Plain-text body (optional if body_html provided)

body_html
string | null

HTML body (optional if body_text provided)

cc
string[] | null

CC recipients

bcc
string[] | null

BCC recipients

attachments
AttachmentItem · object[] | null

File attachments, base64-encoded. At most 5 files -- enforced here with a 422. Total size is not validated by this schema; keep it within what the sending provider accepts.

Response

Email accepted and queued for sending

Outcome of a direct email send.

message_id is the <direct_<leadhex>@domain> stamped on the outbound email; thread_id is the campaign-less external thread the send (and any reply) consolidates into. credits_remaining is the team balance after the 1-credit charge.

success
boolean
required
message
string
required
inbox_id
string<uuid>
required
inbox_email
string
required
recipient_email
string
required
message_id
string
required
thread_id
string<uuid> | null
credits_remaining
integer
default:0