Discord

Send messages and manage channels via a Discord bot

Credentials form9 toolshttps://discord.com/api/v10

POST

discord_send_message

Post a message to a channel. Aggressively rate-limited per channel (a handful of sends per few seconds) — back off using the response's Retry-After header on 429.

/channels/{channel_id}/messages

4 parameters

Param	Type	Required	Description
channel_id	string	required	Snowflake ID of the channel to post in
content	string	required	Message text (up to 2000 characters)
tts	boolean	optional	Send as a text-to-speech message
embeds	array	optional	Rich embed objects to attach (max 10), per Discord's embed object schema

PATCH

discord_edit_message

Edit a message previously sent by this bot

/channels/{channel_id}/messages/{message_id}

3 parameters

Param	Type	Required	Description
channel_id	string	required	Snowflake ID of the channel
message_id	string	required	Snowflake ID of the message to edit
content	string	required	New message text (up to 2000 characters)

DELETE

discord_delete_message

Delete a message. Requires the Manage Messages permission unless it's the bot's own message

/channels/{channel_id}/messages/{message_id}

2 parameters

Param	Type	Required	Description
channel_id	string	required	Snowflake ID of the channel
message_id	string	required	Snowflake ID of the message to delete

GET

discord_list_channel_messages

Fetch recent messages from a channel

/channels/{channel_id}/messages

4 parameters

Param	Type	Required	Description
channel_id	string	required	Snowflake ID of the channel
limit	integer	optional	Max messages to return (1-100, default 50)
before	string	optional	Return messages before this message ID
after	string	optional	Return messages after this message ID

GET

discord_get_channel

Get metadata about a single channel

/channels/{channel_id}

1 parameter

Param	Type	Required	Description
channel_id	string	required	Snowflake ID of the channel

GET

discord_list_guild_channels

List all channels in a Discord server (guild) the bot belongs to

/guilds/{guild_id}/channels

1 parameter

Param	Type	Required	Description
guild_id	string	required	Snowflake ID of the server (guild)

POST

discord_create_guild_channel

Create a new channel in a server. Requires the Manage Channels permission; rate-limited to a small number of creates per 10 minutes per guild

/guilds/{guild_id}/channels

5 parameters

Param	Type	Required	Description
guild_id	string	required	Snowflake ID of the server (guild)
name	string	required	Channel name (1-100 characters)
type	integer	optional	Channel type: 0=text, 2=voice, 4=category, 5=announcement
topic	string	optional	Channel topic (text channels only, max 1024 chars)
parent_id	string	optional	Category channel ID to nest this channel under

PUT

discord_add_reaction

React to a message with an emoji, as the bot. Rate-limited per channel (Discord recommends no more than ~1 reaction/sec)

/channels/{channel_id}/messages/{message_id}/reactions/{emoji}/@me

3 parameters

Param	Type	Required	Description
channel_id	string	required	Snowflake ID of the channel
message_id	string	required	Snowflake ID of the message to react to
emoji	string	required	URL-encoded unicode emoji (e.g. '%F0%9F%91%8D') or 'name:id' for a custom emoji

GET

discord_list_guild_members

List members of a server. Requires the privileged 'Server Members Intent' to be enabled for the bot application in the Developer Portal, or this returns an error

/guilds/{guild_id}/members

3 parameters

Param	Type	Required	Description
guild_id	string	required	Snowflake ID of the server (guild)
limit	integer	optional	Max members to return (1-1000, default 1)
after	string	optional	Return members with a user ID after this value