Skip to main content
POST
Send a message

Authorizations

Authorization
string
header
required

OAuth 2.1 authorization code + PKCE (S256). Tokens are tenant-bound (company_id) and scoped. Discover endpoints via /.well-known/oauth-authorization-server.

Headers

Idempotency-Key
string

Client-chosen key; replaying the same key + body returns the original response, a different body returns 409.

Body

application/json

Send a DM as the company. Provide conversationId to post into an existing conversation, or creatorId to start/continue a DM with a creator (exactly one is required). content is the message text. attachment_ids optionally attaches previously-uploaded files to the delivered message.

content
string
required
conversationId
string
creatorId
string
attachment_ids
string[]

Optional file ids to attach to the delivered message.

Response

The message was sent.

data
object
required