Sign in
Channels
Messages

Send a message

Sends a new message to a channel. Requires permission to send messages in the target channel. Supports text content, embeds, attachments (multipart), and mentions. Returns the created message object with full details.

post/channels/{channel_id}/messages

Path parameters

string snowflake required
OR
integer required

The ID of the channel

Request body

contentstring

The message content. Non-premium users can send up to 2000 characters; premium users, bots, and webhooks can send up to 4000 characters.

flagsinteger

The bitwise flags of the original message

ttsboolean

Whether this is a text-to-speech message

Response

Success

idstring snowflake required
channel_idstring snowflake required
webhook_idstring snowflake
type0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 19 required

The type of message

flagsinteger required

The bitwise flags of the original message

contentstring required

The text content of the message

timestampstring date-time required

The ISO 8601 timestamp of when the message was created

edited_timestampstring date-time nullable

The ISO 8601 timestamp of when the message was last edited

pinnedboolean required

Whether the message is pinned

mention_everyoneboolean required

Whether the message mentions @everyone

ttsboolean required

Whether the message was sent as text-to-speech

mention_rolesstring[] required

The role IDs mentioned in the message

noncestring nullable

A client-provided value for message deduplication

Changes