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

string snowflake required
OR
integer required

The ID of the webhook

tokenstring required

The webhook token

The webhook token

Query parameters

waitstring

Whether to wait for the webhook response

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

The bitwise flags of the original message

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 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