Discord

Usage Instructions

Comprehensive Discord integration: messages, threads, channels, roles, members, invites, and webhooks.

Tools

`discord_send_message`

Send a message to a Discord channel

Input

Parameter	Type	Required	Description
`botToken`	string	Yes	The bot token for authentication
`channelId`	string	Yes	The Discord channel ID to send the message to
`content`	string	No	The text content of the message
`serverId`	string	Yes	The Discord server ID (guild ID)
`files`	file[]	No	Files to attach to the message

Output

Parameter	Type	Description
`message`	string	Success or error message
`data`	object	Discord message data

`discord_get_messages`

Retrieve messages from a Discord channel

Input

Parameter	Type	Required	Description
`botToken`	string	Yes	The bot token for authentication
`channelId`	string	Yes	The Discord channel ID to retrieve messages from
`limit`	number	No	Maximum number of messages to retrieve (default: 10, max: 100)

Output

Parameter	Type	Description
`message`	string	Success or error message
`data`	object	Container for messages data

`discord_get_server`

Retrieve information about a Discord server (guild)

Input

Parameter	Type	Required	Description
`botToken`	string	Yes	The bot token for authentication
`serverId`	string	Yes	The Discord server ID (guild ID)

Output

Parameter	Type	Description
`message`	string	Success or error message
`data`	object	Discord server (guild) information

`discord_get_user`

Retrieve information about a Discord user

Input

Parameter	Type	Required	Description
`botToken`	string	Yes	Discord bot token for authentication
`userId`	string	Yes	The Discord user ID

Output

Parameter	Type	Description
`message`	string	Success or error message
`data`	object	Discord user information

`discord_edit_message`

Edit an existing message in a Discord channel

Input

Parameter	Type	Required	Description
`botToken`	string	Yes	The bot token for authentication
`channelId`	string	Yes	The Discord channel ID containing the message
`messageId`	string	Yes	The ID of the message to edit
`content`	string	No	The new text content for the message
`serverId`	string	Yes	The Discord server ID (guild ID)

Output

Parameter	Type	Description
`message`	string	Success or error message
`data`	object	Updated Discord message data

`discord_delete_message`

Delete a message from a Discord channel

Input

Parameter	Type	Required	Description
`botToken`	string	Yes	The bot token for authentication
`channelId`	string	Yes	The Discord channel ID containing the message
`messageId`	string	Yes	The ID of the message to delete
`serverId`	string	Yes	The Discord server ID (guild ID)

Output

Parameter	Type	Description
`message`	string	Success or error message

`discord_add_reaction`

Add a reaction emoji to a Discord message

Input

Parameter	Type	Required	Description
`botToken`	string	Yes	The bot token for authentication
`channelId`	string	Yes	The Discord channel ID containing the message
`messageId`	string	Yes	The ID of the message to react to
`emoji`	string	Yes	The emoji to react with (unicode emoji or custom emoji in name:id format)
`serverId`	string	Yes	The Discord server ID (guild ID)

Output

Parameter	Type	Description
`message`	string	Success or error message

`discord_remove_reaction`

Remove a reaction from a Discord message

Input

Parameter	Type	Required	Description
`botToken`	string	Yes	The bot token for authentication
`channelId`	string	Yes	The Discord channel ID containing the message
`messageId`	string	Yes	The ID of the message with the reaction
`emoji`	string	Yes	The emoji to remove (unicode emoji or custom emoji in name:id format)
`userId`	string	No	The user ID whose reaction to remove (omit to remove bot's own reaction)
`serverId`	string	Yes	The Discord server ID (guild ID)

Output

Parameter	Type	Description
`message`	string	Success or error message

`discord_pin_message`

Pin a message in a Discord channel

Input

Parameter	Type	Required	Description
`botToken`	string	Yes	The bot token for authentication
`channelId`	string	Yes	The Discord channel ID containing the message
`messageId`	string	Yes	The ID of the message to pin
`serverId`	string	Yes	The Discord server ID (guild ID)

Output

Parameter	Type	Description
`message`	string	Success or error message

`discord_unpin_message`

Unpin a message in a Discord channel

Input

Parameter	Type	Required	Description
`botToken`	string	Yes	The bot token for authentication
`channelId`	string	Yes	The Discord channel ID containing the message
`messageId`	string	Yes	The ID of the message to unpin
`serverId`	string	Yes	The Discord server ID (guild ID)

Output

Parameter	Type	Description
`message`	string	Success or error message

`discord_create_thread`

Create a thread in a Discord channel

Input

Parameter	Type	Required	Description
`botToken`	string	Yes	The bot token for authentication
`channelId`	string	Yes	The Discord channel ID to create the thread in
`name`	string	Yes	The name of the thread (1-100 characters)
`messageId`	string	No	The message ID to create a thread from (if creating from existing message)
`autoArchiveDuration`	number	No	Duration in minutes to auto-archive the thread (60, 1440, 4320, 10080)
`serverId`	string	Yes	The Discord server ID (guild ID)

Output

Parameter	Type	Description
`message`	string	Success or error message
`data`	object	Created thread data

`discord_join_thread`

Join a thread in Discord

Input

Parameter	Type	Required	Description
`botToken`	string	Yes	The bot token for authentication
`threadId`	string	Yes	The thread ID to join
`serverId`	string	Yes	The Discord server ID (guild ID)

Output

Parameter	Type	Description
`message`	string	Success or error message

`discord_leave_thread`

Leave a thread in Discord

Input

Parameter	Type	Required	Description
`botToken`	string	Yes	The bot token for authentication
`threadId`	string	Yes	The thread ID to leave
`serverId`	string	Yes	The Discord server ID (guild ID)

Output

Parameter	Type	Description
`message`	string	Success or error message

`discord_archive_thread`

Archive or unarchive a thread in Discord

Input

Parameter	Type	Required	Description
`botToken`	string	Yes	The bot token for authentication
`threadId`	string	Yes	The thread ID to archive/unarchive
`archived`	boolean	Yes	Whether to archive (true) or unarchive (false) the thread
`serverId`	string	Yes	The Discord server ID (guild ID)

Output

Parameter	Type	Description
`message`	string	Success or error message
`data`	object	Updated thread data

`discord_create_channel`

Create a new channel in a Discord server

Input

Parameter	Type	Required	Description
`botToken`	string	Yes	The bot token for authentication
`serverId`	string	Yes	The Discord server ID (guild ID)
`name`	string	Yes	The name of the channel (1-100 characters)
`type`	number	No	Channel type (0=text, 2=voice, 4=category, 5=announcement, 13=stage)
`topic`	string	No	Channel topic (0-1024 characters)
`parentId`	string	No	Parent category ID for the channel

Output

Parameter	Type	Description
`message`	string	Success or error message
`data`	object	Created channel data

`discord_update_channel`

Update a Discord channel

Input

Parameter	Type	Required	Description
`botToken`	string	Yes	The bot token for authentication
`channelId`	string	Yes	The Discord channel ID to update
`name`	string	No	The new name for the channel
`topic`	string	No	The new topic for the channel
`serverId`	string	Yes	The Discord server ID (guild ID)

Output

Parameter	Type	Description
`message`	string	Success or error message
`data`	object	Updated channel data

`discord_delete_channel`

Delete a Discord channel

Input

Parameter	Type	Required	Description
`botToken`	string	Yes	The bot token for authentication
`channelId`	string	Yes	The Discord channel ID to delete
`serverId`	string	Yes	The Discord server ID (guild ID)

Output

Parameter	Type	Description
`message`	string	Success or error message

`discord_get_channel`

Get information about a Discord channel

Input

Parameter	Type	Required	Description
`botToken`	string	Yes	The bot token for authentication
`channelId`	string	Yes	The Discord channel ID to retrieve
`serverId`	string	Yes	The Discord server ID (guild ID)

Output

Parameter	Type	Description
`message`	string	Success or error message
`data`	object	Channel data

`discord_create_role`

Create a new role in a Discord server

Input

Parameter	Type	Required	Description
`botToken`	string	Yes	The bot token for authentication
`serverId`	string	Yes	The Discord server ID (guild ID)
`name`	string	Yes	The name of the role
`color`	number	No	RGB color value as integer (e.g., 0xFF0000 for red)
`hoist`	boolean	No	Whether to display role members separately from online members
`mentionable`	boolean	No	Whether the role can be mentioned

Output

Parameter	Type	Description
`message`	string	Success or error message
`data`	object	Created role data

`discord_update_role`

Update a role in a Discord server

Input

Parameter	Type	Required	Description
`botToken`	string	Yes	The bot token for authentication
`serverId`	string	Yes	The Discord server ID (guild ID)
`roleId`	string	Yes	The role ID to update
`name`	string	No	The new name for the role
`color`	number	No	RGB color value as integer
`hoist`	boolean	No	Whether to display role members separately
`mentionable`	boolean	No	Whether the role can be mentioned

Output

Parameter	Type	Description
`message`	string	Success or error message
`data`	object	Updated role data

`discord_delete_role`

Delete a role from a Discord server

Input

Parameter	Type	Required	Description
`botToken`	string	Yes	The bot token for authentication
`serverId`	string	Yes	The Discord server ID (guild ID)
`roleId`	string	Yes	The role ID to delete

Output

Parameter	Type	Description
`message`	string	Success or error message

`discord_assign_role`

Assign a role to a member in a Discord server

Input

Parameter	Type	Required	Description
`botToken`	string	Yes	The bot token for authentication
`serverId`	string	Yes	The Discord server ID (guild ID)
`userId`	string	Yes	The user ID to assign the role to
`roleId`	string	Yes	The role ID to assign

Output

Parameter	Type	Description
`message`	string	Success or error message

`discord_remove_role`

Remove a role from a member in a Discord server

Input

Parameter	Type	Required	Description
`botToken`	string	Yes	The bot token for authentication
`serverId`	string	Yes	The Discord server ID (guild ID)
`userId`	string	Yes	The user ID to remove the role from
`roleId`	string	Yes	The role ID to remove

Output

Parameter	Type	Description
`message`	string	Success or error message

`discord_kick_member`

Kick a member from a Discord server

Input

Parameter	Type	Required	Description
`botToken`	string	Yes	The bot token for authentication
`serverId`	string	Yes	The Discord server ID (guild ID)
`userId`	string	Yes	The user ID to kick
`reason`	string	No	Reason for kicking the member

Output

Parameter	Type	Description
`message`	string	Success or error message

`discord_ban_member`

Ban a member from a Discord server

Input

Parameter	Type	Required	Description
`botToken`	string	Yes	The bot token for authentication
`serverId`	string	Yes	The Discord server ID (guild ID)
`userId`	string	Yes	The user ID to ban
`reason`	string	No	Reason for banning the member
`deleteMessageDays`	number	No	Number of days to delete messages for (0-7)

Output

Parameter	Type	Description
`message`	string	Success or error message

`discord_unban_member`

Unban a member from a Discord server

Input

Parameter	Type	Required	Description
`botToken`	string	Yes	The bot token for authentication
`serverId`	string	Yes	The Discord server ID (guild ID)
`userId`	string	Yes	The user ID to unban
`reason`	string	No	Reason for unbanning the member

Output

Parameter	Type	Description
`message`	string	Success or error message

`discord_get_member`

Get information about a member in a Discord server

Input

Parameter	Type	Required	Description
`botToken`	string	Yes	The bot token for authentication
`serverId`	string	Yes	The Discord server ID (guild ID)
`userId`	string	Yes	The user ID to retrieve

Output

Parameter	Type	Description
`message`	string	Success or error message
`data`	object	Member data

`discord_update_member`

Update a member in a Discord server (e.g., change nickname)

Input

Parameter	Type	Required	Description
`botToken`	string	Yes	The bot token for authentication
`serverId`	string	Yes	The Discord server ID (guild ID)
`userId`	string	Yes	The user ID to update
`nick`	string	No	New nickname for the member (null to remove)
`mute`	boolean	No	Whether to mute the member in voice channels
`deaf`	boolean	No	Whether to deafen the member in voice channels

Output

Parameter	Type	Description
`message`	string	Success or error message
`data`	object	Updated member data

`discord_create_invite`

Create an invite link for a Discord channel

Input

Parameter	Type	Required	Description
`botToken`	string	Yes	The bot token for authentication
`channelId`	string	Yes	The Discord channel ID to create an invite for
`maxAge`	number	No	Duration of invite in seconds (0 = never expires, default 86400)
`maxUses`	number	No	Max number of uses (0 = unlimited, default 0)
`temporary`	boolean	No	Whether invite grants temporary membership
`serverId`	string	Yes	The Discord server ID (guild ID)

Output

Parameter	Type	Description
`message`	string	Success or error message
`data`	object	Created invite data

`discord_get_invite`

Get information about a Discord invite

Input

Parameter	Type	Required	Description
`botToken`	string	Yes	The bot token for authentication
`inviteCode`	string	Yes	The invite code to retrieve
`serverId`	string	Yes	The Discord server ID (guild ID)

Output

Parameter	Type	Description
`message`	string	Success or error message
`data`	object	Invite data

`discord_delete_invite`

Delete a Discord invite

Input

Parameter	Type	Required	Description
`botToken`	string	Yes	The bot token for authentication
`inviteCode`	string	Yes	The invite code to delete
`serverId`	string	Yes	The Discord server ID (guild ID)

Output

Parameter	Type	Description
`message`	string	Success or error message

`discord_create_webhook`

Create a webhook in a Discord channel

Input

Parameter	Type	Required	Description
`botToken`	string	Yes	The bot token for authentication
`channelId`	string	Yes	The Discord channel ID to create the webhook in
`name`	string	Yes	Name of the webhook (1-80 characters)
`serverId`	string	Yes	The Discord server ID (guild ID)

Output

Parameter	Type	Description
`message`	string	Success or error message
`data`	object	Created webhook data

`discord_execute_webhook`

Execute a Discord webhook to send a message

Input

Parameter	Type	Required	Description
`webhookId`	string	Yes	The webhook ID
`webhookToken`	string	Yes	The webhook token
`content`	string	Yes	The message content to send
`username`	string	No	Override the default username of the webhook
`serverId`	string	Yes	The Discord server ID (guild ID)

Output

Parameter	Type	Description
`message`	string	Success or error message
`data`	object	Message sent via webhook

`discord_get_webhook`

Get information about a Discord webhook

Input

Parameter	Type	Required	Description
`botToken`	string	Yes	The bot token for authentication
`webhookId`	string	Yes	The webhook ID to retrieve
`serverId`	string	Yes	The Discord server ID (guild ID)

Output

Parameter	Type	Description
`message`	string	Success or error message
`data`	object	Webhook data

`discord_delete_webhook`

Delete a Discord webhook

Input

Parameter	Type	Required	Description
`botToken`	string	Yes	The bot token for authentication
`webhookId`	string	Yes	The webhook ID to delete
`serverId`	string	Yes	The Discord server ID (guild ID)

Output

Parameter	Type	Description
`message`	string	Success or error message

Notes

Category: tools
Type: discord

Discord

On this page