Skip to main content
POST
Send Message

Authorizations

Authorization
string
header
required

An App API key, an account-scoped user token, or a user OAuth token. Prepend the key or token with Bearer, for example Bearer ***************************. See Auth & API keys for how to get each one.

Headers

Idempotency-Key
string

A unique key that makes this request safe to retry. See Idempotent requests.

Maximum string length: 255
Example:

"d9105228-4a08-46b1-8b91-42fed586d383"

Api-Version-Date
string

Pins the request to a dated API version.

Example:

"2026-11-07"

Body

application/json
channel_id
string
required

Public channel ID, or an experience ID for experience chat.

Example:

"feed_xxxxxxxxxxxxxxxxxxxxxx"

content
string
required

Markdown content. May be empty when the message contains media or a poll.

Maximum string length: 5000
Example:

"New **message**"

attachments
object[]

Files to attach to the message.

Generate previews for URLs in content. Mutually exclusive with link_previews.

Explicit URLs for the server to preview.

poll
object
replying_to_message_id
string

A live message in the same channel to reply to.

Response

message sent

attachments
object[]
required
author
object | null
required
author_is_team_member
boolean
required

true if the author is a team member of the account that owns this community channel. false for partners, private and support channels, and deleted messages.

Example:

false

author_user_id
string | null
required
Example:

"user_xxxxxxxxxxxxxx"

channel_id
string
required
Example:

"feed_xxxxxxxxxxxxxxxxxxxxxx"

content
string | null
required

Markdown content; null for a deleted message.

Example:

"Content 1"

created_at
string
required

Creation time as an ISO 8601 timestamp.

Example:

"2026-01-01T12:00:00.000Z"

custom_author
object | null
required
deleted_at
string | null
required

Deletion time, or null for a live message.

Example:

null

edited
boolean
required
Example:

false

embeds
object[]
required
gifs
object[]
required
id
string
required

Existing public message ID, preserved across REST and chat clients.

Example:

"post_xxxxxxxxxxxxxxxxxxxxxx"

mentioned_user_ids
string[]
required
message_type
enum<string>
required
Available options:
regular,
system,
automated
Example:

"regular"

pinned
boolean
required
Example:

false

plain_content
string | null
required

Unformatted message text. null when the text is absent or the message is deleted

Example:

"Content 1"

poll
object | null
required
reaction_counts
object[]
required
replying_to_message_id
string | null
required
Example:

null

replying_to_user_id
string | null
required

User ID of the replied-to message's author, prefixed user_. null without a reply in this channel, or when either message is deleted.

Example:

null

updated_at
string
required

Last message change as an ISO 8601 timestamp.

Example:

"2026-01-01T12:00:00.000Z"

view_count
integer | null
required

Experience view count; null for DM-backed channels.

Example:

null