Skip to main content
POST
Post a merchant message on a case

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

caseId
string
required

Platform case id (cas_{ULID})

Pattern: ^cas_[0-9A-HJKMNP-TV-Z]{26}$
Example:

"cas_01ARZ3NDEKTSV4RRFFQ69G5AV"

Body

application/json

Opening or reply message body. Optional client ULID for idempotent create.

body
string
required

Plain-text message body (max 32,000 characters, per Salesforce long text area)

Required string length: 1 - 32000
Example:

"The customer asked to move the appointment to next week."

messageId
string

Client-generated id (csmsg_{ULID}). When provided the server uses it as the canonical message id, enabling optimistic UI.

Pattern: ^csmsg_[0-9A-HJKMNP-TV-Z]{26}$
Example:

"csmsg_01K3P7YQ35N9VZC6SD1WYPEJG2"

Response

Message posted successfully

The message that was posted

data
object
required

One message in a Case conversation. Immutable through the API; erasure is a tombstone.