Skip to main content
POST
Send Message

Yetkilendirmeler

Authorization
string
header
gerekli

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.

Scopes

dms:message:manage
chat:message:create
support_chat:message:create

Başlıklar

Idempotency-Key
string

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

Maximum string length: 255
Örnek:

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

Api-Version-Date
string

Pins the request to a dated API version.

Örnek:

"2026-11-17"

Gövde

application/json
channel_id
string
gerekli

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

Örnek:

"feed_xxxxxxxxxxxxxxxxxxxxxx"

content
string
gerekli

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

Maximum string length: 5000
Örnek:

"New **message**"

attachments
object[]

Files to attach to the message.

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

email_address
string

Also send this message as an email from this email address. Pass the address, like support@example.com, or its ID, prefixed emaddr_.

gifs
object[]

Up to 10 GIFs to attach. URLs must use HTTPS on static.klipy.com, static1.klipy.com, or static2.klipy.com. Omit to preserve on edit; an empty list clears them.

Maximum array length: 10
id
string

Optional, for clients that show a message before the server confirms it. Use post_ followed by 22 Base58 characters. Omit to generate an ID. Reuse the same ID and Idempotency-Key when retrying a send.

Pattern: ^post_[1-9A-HJ-NP-Za-km-z]{22}$

Explicit URLs for the server to preview.

poll
object
replying_to_message_id
string

A live message in the same channel to reply to.

Yanıt

message sent

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

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.

Örnek:

false

author_user_id
string | null
gerekli
Örnek:

"user_xxxxxxxxxxxxxx"

channel_id
string
gerekli
Örnek:

"feed_xxxxxxxxxxxxxxxxxxxxxx"

content
string | null
gerekli

Markdown content. null for a deleted message.

Örnek:

"Content 1"

created_at
string
gerekli

Creation time as an ISO 8601 timestamp.

Örnek:

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

custom_author
object | null
gerekli
deleted_at
string | null
gerekli

Deletion time, or null for a live message.

Örnek:

null

edited
boolean
gerekli
Örnek:

false

embeds
object[]
gerekli
gifs
object[]
gerekli
id
string
gerekli

Message ID, prefixed post_. Matches the id sent on create, when one was sent.

Örnek:

"post_xxxxxxxxxxxxxxxxxxxxxx"

mentioned_user_ids
string[]
gerekli
message_type
enum<string>
gerekli
Mevcut seçenekler:
regular,
system,
automated
Örnek:

"regular"

pinned
boolean
gerekli
Örnek:

false

plain_content
string | null
gerekli

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

Örnek:

"Content 1"

poll
object | null
gerekli
reaction_counts
object[]
gerekli
replying_to_message_id
string | null
gerekli
Örnek:

null

replying_to_user_id
string | null
gerekli

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

Örnek:

null

updated_at
string
gerekli

Last message change as an ISO 8601 timestamp.

Örnek:

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

view_count
integer | null
gerekli

Experience view count. null for DM-backed channels.

Örnek:

null

replying_to_message
any | null

The replied-to message. Omitted unless include_replying_to_message=true. Includes all message fields except replying_to_message. null when this message is deleted or no same-channel target exists.