Skip to main content
POST
Create a conversation message

Authorizations

Authorization
string
header
required

Bearer token authentication

Path Parameters

conversation_id
string
required

Body

application/json
user
object

The company admin to act as. Required.

message
object

Required.

Response

Created

A message in a conversation, as seen by the acting recipient.

app
object | null

For a message an incoming webhook or an app's own Flow sender posted, the app it shows as (name, icon_url); null otherwise.

sent_via
object | null

For a message an app sent as a person who allowed it to, the app it was sent through; null otherwise.

blocks
object[]

The bot's interactive cards on this message (see the messaging v1 MessagingMessageBlock); empty for a person's message.

uuid_v7
string<uuid>

The stable UUIDv7 identifier. Messaging routes accept it wherever they accept the numeric id.

id
integer
conversation_id
integer | null
type
string | null

Message type, for example DirectMessage, SmsMessage, or EmailMessage.

status
string | null

Delivery status: queued, sent, or failed.

body
string | null

Message text.

metadata
any

Free-form metadata sent with the message.

attachments
object[]
sender_recipient
object | null

The recipient who sent the message.

replied_to_message
object | null

The message this one replies to, in the same shape, or null.

mentioned_recipients
object[]

Recipients mentioned in the message.

seen_by
object[]

Up to 25 recipients who have seen the message. Always empty in channels.

seen_by_count
integer | null
reaction
string | null

The acting recipient's reaction, if any.

reaction_stats
any

Reaction counts.

emoji_only_count
integer | null
pinned
boolean | null
sent_at
string<date-time> | null
edited_at
string<date-time> | null
deleted_at
string<date-time> | null
created_at
string<date-time>
updated_at
string<date-time>