Sign in
Webhooks

Execute webhook

Executes the webhook by sending a message to its configured channel. If the wait query parameter is true, returns the created message object; otherwise returns a 204 status with no content.

post/webhooks/{webhook_id}/{token}

Path parameters

webhook_idstring snowflake required

The ID of the webhook

tokenstring required

The token

Query parameters

waitstring

Whether to wait for the webhook response

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

Message flags bitfield

noncestring

Client-generated identifier for the message

favorite_meme_idstring snowflake
sticker_idsSnowflakeType[] nullable

Array of sticker IDs to include (max 3)

ttsboolean

Whether this is a text-to-speech message

usernamestring nullable

Override the default username of the webhook for this message

avatar_urlstring nullable

Override the default avatar URL of the webhook for this message

Response

Success

idstring required

The unique identifier (snowflake) for this message

channel_idstring required

The ID of the channel this message was sent in

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

The type of message

flagsinteger required

Message flags bitfield

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

nsfw_emojisSnowflakeType[]

IDs of custom emojis in this message that are classified as NSFW

noncestring nullable

A client-provided value for message deduplication

Changes