Skip to main content
POST
Compose and send a new inbox message

Authorizations

Authorization
string
header
required

Breakcold public API key, for example Bearer bc_live_....

Headers

X-Breakcold-Organization-Id
string

Breakcold organization ID. API keys already carry their organization, so most API-key requests do not need this header. Use it only when Breakcold asks you to choose an organization for a signed-in user token.

Idempotency-Key
string

Stable unique key for the intended write. Reuse the same key when retrying the same request; use a different key for an intentional duplicate.

Required string length: 1 - 200

Body

application/json
workspaceId
string
required
Minimum string length: 6
workspaceIntegrationAccountId
string
required
Minimum string length: 6
channel
enum<string>
required
Available options:
email,
linkedin,
telegram,
whatsapp
textPlain
string
required
textHtml
string
recordId
string
Minimum string length: 6
attachments
object[]
email
object
socialIdentifier
string

Recipient identifier for social channels, such as the provider username, account identifier, or phone number expected by the selected LinkedIn, Telegram, or WhatsApp account.

Response

Success

conversation
object
required
message
object
required
providerMessageId
string