Skip to content
Try for free
On this page

Integrations

Discord

Interact with Discord

Use Discord to manage messages, threads, channels, roles, members, invites, and webhooks. Authenticate with a bot token and grant the bot access to the servers and channels the workflow needs.

Set up your Discord bot

  1. Open the Discord Developer Portal and create an application.
  2. Open Bot, create the bot if needed, and copy its token.
  3. Under Privileged Gateway Intents, enable Message Content Intent when the workflow needs message content.
  4. Invite the bot to your servers with the permissions required by its operations.

Discord restricts content, embeds, attachments, and components when the Message Content intent is unavailable, with exceptions such as messages sent by the bot, direct messages, and messages that mention it. Verified apps may need approval for this intent. See Discord's Message Content requirements.

Use the block

Manage Discord messages, threads, channels, roles, members, invites, and webhooks.

Actions

Discord Send Message

Send a message to a Discord channel

Inputs and outputs

Input

ParameterTypeRequiredDescription
botTokenstringYesThe bot token for authentication
channelIdstringYesThe Discord channel ID to send the message to, e.g., 123456789012345678
contentstringNoThe text content of the message
serverIdstringYesThe Discord server ID (guild ID), e.g., 123456789012345678
filesfile[]NoFiles to attach to the message

Output

ParameterTypeDescription
messagestringSuccess or error message
filesfile[]Files attached to the message
dataobjectDiscord message data
↳ idstringMessage ID
↳ contentstringMessage content
↳ channel_idstringChannel ID where message was sent
↳ authorobjectMessage author information
↳ idstringAuthor user ID
↳ usernamestringAuthor username
↳ avatarstringAuthor avatar hash
↳ botbooleanWhether author is a bot
↳ timestampstringMessage timestamp
↳ edited_timestampstringMessage edited timestamp
↳ embedsarrayMessage embeds
↳ attachmentsarrayMessage attachments
↳ mentionsarrayUser mentions in message
↳ mention_rolesarrayRole mentions in message
↳ mention_everyonebooleanWhether message mentions everyone

Discord Get Messages

Retrieve messages from a Discord channel

Inputs and outputs

Input

ParameterTypeRequiredDescription
botTokenstringYesThe bot token for authentication
channelIdstringYesThe Discord channel ID to retrieve messages from, e.g., 123456789012345678
limitnumberNoMaximum number of messages to retrieve (default: 10, max: 100)

Output

ParameterTypeDescription
messagestringSuccess or error message
dataobjectContainer for messages data
↳ messagesarrayArray of Discord messages with full metadata
↳ idstringMessage ID
↳ contentstringMessage content
↳ channel_idstringChannel ID
↳ authorobjectMessage author information
↳ idstringAuthor user ID
↳ usernamestringAuthor username
↳ avatarstringAuthor avatar hash
↳ botbooleanWhether author is a bot
↳ timestampstringMessage timestamp
↳ edited_timestampstringMessage edited timestamp
↳ embedsarrayMessage embeds
↳ attachmentsarrayMessage attachments
↳ mentionsarrayUser mentions in message
↳ mention_rolesarrayRole mentions in message
↳ mention_everyonebooleanWhether message mentions everyone
↳ channel_idstringChannel ID

Discord Get Server

Retrieve information about a Discord server (guild)

Inputs and outputs

Input

ParameterTypeRequiredDescription
botTokenstringYesThe bot token for authentication
serverIdstringYesThe Discord server ID (guild ID), e.g., 123456789012345678

Output

ParameterTypeDescription
messagestringSuccess or error message
dataobjectDiscord server (guild) information
↳ idstringServer ID
↳ namestringServer name
↳ iconstringServer icon hash
↳ descriptionstringServer description
↳ owner_idstringServer owner user ID
↳ rolesarrayServer roles
↳ approximate_member_countnumberApproximate total member count
↳ approximate_presence_countnumberApproximate online member count

Discord Get User

Retrieve information about a Discord user

Inputs and outputs

Input

ParameterTypeRequiredDescription
botTokenstringYesDiscord bot token for authentication
userIdstringYesThe Discord user ID, e.g., 123456789012345678

Output

ParameterTypeDescription
messagestringSuccess or error message
dataobjectDiscord user information
↳ idstringUser ID
↳ usernamestringUsername
↳ discriminatorstringUser discriminator (4-digit number)
↳ avatarstringUser avatar hash
↳ botbooleanWhether user is a bot
↳ systembooleanWhether user is a system user
↳ emailstringUser email (if available)
↳ verifiedbooleanWhether user email is verified

Discord Edit Message

Edit an existing message in a Discord channel

Inputs and outputs

Input

ParameterTypeRequiredDescription
botTokenstringYesThe bot token for authentication
channelIdstringYesThe Discord channel ID containing the message, e.g., 123456789012345678
messageIdstringYesThe ID of the message to edit, e.g., 123456789012345678
contentstringNoThe new text content for the message
serverIdstringYesThe Discord server ID (guild ID), e.g., 123456789012345678

Output

ParameterTypeDescription
messagestringSuccess or error message
dataobjectUpdated Discord message data
↳ idstringMessage ID
↳ contentstringUpdated message content
↳ channel_idstringChannel ID
↳ edited_timestampstringMessage edited timestamp

Discord Delete Message

Delete a message from a Discord channel

Inputs and outputs

Input

ParameterTypeRequiredDescription
botTokenstringYesThe bot token for authentication
channelIdstringYesThe Discord channel ID containing the message, e.g., 123456789012345678
messageIdstringYesThe ID of the message to delete, e.g., 123456789012345678
serverIdstringYesThe Discord server ID (guild ID), e.g., 123456789012345678

Output

ParameterTypeDescription
messagestringSuccess or error message

Discord Bulk Delete Messages

Delete 2-100 messages from a Discord channel in a single request

Inputs and outputs

Input

ParameterTypeRequiredDescription
botTokenstringYesThe bot token for authentication
channelIdstringYesThe Discord channel ID to delete messages from, e.g., 123456789012345678
messageIdsjsonYesArray of 2-100 message IDs to delete. Messages older than 2 weeks cannot be bulk deleted.
serverIdstringYesThe Discord server ID (guild ID), e.g., 123456789012345678

Output

ParameterTypeDescription
messagestringSuccess or error message

Discord Add Reaction

Add a reaction emoji to a Discord message

Inputs and outputs

Input

ParameterTypeRequiredDescription
botTokenstringYesThe bot token for authentication
channelIdstringYesThe Discord channel ID containing the message, e.g., 123456789012345678
messageIdstringYesThe ID of the message to react to, e.g., 123456789012345678
emojistringYesThe emoji to react with (unicode emoji or custom emoji in name:id format)
serverIdstringYesThe Discord server ID (guild ID), e.g., 123456789012345678

Output

ParameterTypeDescription
messagestringSuccess or error message

Discord Remove Reaction

Remove a reaction from a Discord message

Inputs and outputs

Input

ParameterTypeRequiredDescription
botTokenstringYesThe bot token for authentication
channelIdstringYesThe Discord channel ID containing the message, e.g., 123456789012345678
messageIdstringYesThe ID of the message with the reaction, e.g., 123456789012345678
emojistringYesThe emoji to remove (unicode emoji or custom emoji in name:id format)
userIdstringNoThe user ID whose reaction to remove (omit to remove bot's own reaction), e.g., 123456789012345678
serverIdstringYesThe Discord server ID (guild ID), e.g., 123456789012345678

Output

ParameterTypeDescription
messagestringSuccess or error message

Discord Pin Message

Pin a message in a Discord channel

Inputs and outputs

Input

ParameterTypeRequiredDescription
botTokenstringYesThe bot token for authentication
channelIdstringYesThe Discord channel ID containing the message, e.g., 123456789012345678
messageIdstringYesThe ID of the message to pin, e.g., 123456789012345678
serverIdstringYesThe Discord server ID (guild ID), e.g., 123456789012345678

Output

ParameterTypeDescription
messagestringSuccess or error message

Discord Unpin Message

Unpin a message in a Discord channel

Inputs and outputs

Input

ParameterTypeRequiredDescription
botTokenstringYesThe bot token for authentication
channelIdstringYesThe Discord channel ID containing the message, e.g., 123456789012345678
messageIdstringYesThe ID of the message to unpin, e.g., 123456789012345678
serverIdstringYesThe Discord server ID (guild ID), e.g., 123456789012345678

Output

ParameterTypeDescription
messagestringSuccess or error message

Discord Get Pinned Messages

Retrieve all pinned messages in a Discord channel

Inputs and outputs

Input

ParameterTypeRequiredDescription
botTokenstringYesThe bot token for authentication
channelIdstringYesThe Discord channel ID to retrieve pinned messages from, e.g., 123456789012345678
limitnumberNoMaximum number of pins to return per page (1-50). Defaults to 50.
beforestringNoReturn pins created before this ISO8601 timestamp, for paging past the first 50 results

Output

ParameterTypeDescription
messagestringSuccess or error message
dataarrayArray of pinned Discord messages
↳ idstringMessage ID
↳ contentstringMessage content
↳ channel_idstringChannel ID
↳ timestampstringMessage timestamp
↳ pinned_atstringWhen the message was pinned
↳ authorobjectMessage author information
↳ idstringAuthor user ID
↳ usernamestringAuthor username
hasMorebooleanWhether more pinned messages exist beyond this page

Discord Create Thread

Create a thread in a Discord channel

Inputs and outputs

Input

ParameterTypeRequiredDescription
botTokenstringYesThe bot token for authentication
channelIdstringYesThe Discord channel ID to create the thread in, e.g., 123456789012345678
namestringYesThe name of the thread (1-100 characters)
messageIdstringNoThe message ID to create a thread from (if creating from existing message), e.g., 123456789012345678
autoArchiveDurationnumberNoDuration in minutes to auto-archive the thread (60, 1440, 4320, 10080)
isPublicbooleanNoWhether the standalone thread is public (visible to everyone in the channel) or private. Ignored when creating a thread from an existing message, which always inherits the parent channel visibility. Defaults to public if omitted.
serverIdstringYesThe Discord server ID (guild ID), e.g., 123456789012345678

Output

ParameterTypeDescription
messagestringSuccess or error message
dataobjectCreated thread data
↳ idstringThread ID
↳ namestringThread name
↳ typenumberThread channel type
↳ guild_idstringServer ID
↳ parent_idstringParent channel ID

Discord Join Thread

Join a thread in Discord

Inputs and outputs

Input

ParameterTypeRequiredDescription
botTokenstringYesThe bot token for authentication
threadIdstringYesThe thread ID to join, e.g., 123456789012345678
serverIdstringYesThe Discord server ID (guild ID), e.g., 123456789012345678

Output

ParameterTypeDescription
messagestringSuccess or error message

Discord Leave Thread

Leave a thread in Discord

Inputs and outputs

Input

ParameterTypeRequiredDescription
botTokenstringYesThe bot token for authentication
threadIdstringYesThe thread ID to leave, e.g., 123456789012345678
serverIdstringYesThe Discord server ID (guild ID), e.g., 123456789012345678

Output

ParameterTypeDescription
messagestringSuccess or error message

Discord Archive Thread

Archive or unarchive a thread in Discord

Inputs and outputs

Input

ParameterTypeRequiredDescription
botTokenstringYesThe bot token for authentication
threadIdstringYesThe thread ID to archive/unarchive, e.g., 123456789012345678
archivedbooleanYesWhether to archive (true) or unarchive (false) the thread
serverIdstringYesThe Discord server ID (guild ID), e.g., 123456789012345678

Output

ParameterTypeDescription
messagestringSuccess or error message
dataobjectUpdated thread data
↳ idstringThread ID
↳ archivedbooleanWhether thread is archived

Discord Create Channel

Create a new channel in a Discord server

Inputs and outputs

Input

ParameterTypeRequiredDescription
botTokenstringYesThe bot token for authentication
serverIdstringYesThe Discord server ID (guild ID), e.g., 123456789012345678
namestringYesThe name of the channel (1-100 characters)
typenumberNoChannel type (0=text, 2=voice, 4=category, 5=announcement, 13=stage)
topicstringNoChannel topic (0-1024 characters)
parentIdstringNoParent category ID for the channel, e.g., 123456789012345678

Output

ParameterTypeDescription
messagestringSuccess or error message
dataobjectCreated channel data
↳ idstringChannel ID
↳ namestringChannel name
↳ typenumberChannel type
↳ guild_idstringServer ID

Discord Update Channel

Update a Discord channel

Inputs and outputs

Input

ParameterTypeRequiredDescription
botTokenstringYesThe bot token for authentication
channelIdstringYesThe Discord channel ID to update, e.g., 123456789012345678
namestringNoThe new name for the channel
topicstringNoThe new topic for the channel
serverIdstringYesThe Discord server ID (guild ID), e.g., 123456789012345678

Output

ParameterTypeDescription
messagestringSuccess or error message
dataobjectUpdated channel data
↳ idstringChannel ID
↳ namestringChannel name
↳ typenumberChannel type
↳ topicstringChannel topic

Discord Delete Channel

Delete a Discord channel

Inputs and outputs

Input

ParameterTypeRequiredDescription
botTokenstringYesThe bot token for authentication
channelIdstringYesThe Discord channel ID to delete, e.g., 123456789012345678
serverIdstringYesThe Discord server ID (guild ID), e.g., 123456789012345678

Output

ParameterTypeDescription
messagestringSuccess or error message
dataobjectThe deleted channel, as returned by Discord
↳ idstringChannel ID
↳ namestringChannel name
↳ typenumberChannel type
↳ guild_idstringServer ID

Discord Get Channel

Get information about a Discord channel

Inputs and outputs

Input

ParameterTypeRequiredDescription
botTokenstringYesThe bot token for authentication
channelIdstringYesThe Discord channel ID to retrieve, e.g., 123456789012345678
serverIdstringYesThe Discord server ID (guild ID), e.g., 123456789012345678

Output

ParameterTypeDescription
messagestringSuccess or error message
dataobjectChannel data
↳ idstringChannel ID
↳ namestringChannel name
↳ typenumberChannel type
↳ topicstringChannel topic
↳ guild_idstringServer ID

Discord List Channels

List all channels in a Discord server

Inputs and outputs

Input

ParameterTypeRequiredDescription
botTokenstringYesThe bot token for authentication
serverIdstringYesThe Discord server ID (guild ID), e.g., 123456789012345678

Output

ParameterTypeDescription
messagestringSuccess or error message
dataarrayArray of Discord channels in the server
↳ idstringChannel ID
↳ namestringChannel name
↳ typenumberChannel type
↳ topicstringChannel topic
↳ parent_idstringParent category ID
↳ positionnumberSort position within the channel list

Discord Create Role

Create a new role in a Discord server

Inputs and outputs

Input

ParameterTypeRequiredDescription
botTokenstringYesThe bot token for authentication
serverIdstringYesThe Discord server ID (guild ID), e.g., 123456789012345678
namestringYesThe name of the role
colornumberNoRGB color value as integer (e.g., 0xFF0000 for red)
hoistbooleanNoWhether to display role members separately from online members
mentionablebooleanNoWhether the role can be mentioned

Output

ParameterTypeDescription
messagestringSuccess or error message
dataobjectCreated role data
↳ idstringRole ID
↳ namestringRole name
↳ colornumberRole color
↳ hoistbooleanWhether role is hoisted
↳ mentionablebooleanWhether role is mentionable

Discord Update Role

Update a role in a Discord server

Inputs and outputs

Input

ParameterTypeRequiredDescription
botTokenstringYesThe bot token for authentication
serverIdstringYesThe Discord server ID (guild ID), e.g., 123456789012345678
roleIdstringYesThe role ID to update, e.g., 123456789012345678
namestringNoThe new name for the role
colornumberNoRGB color value as integer
hoistbooleanNoWhether to display role members separately
mentionablebooleanNoWhether the role can be mentioned

Output

ParameterTypeDescription
messagestringSuccess or error message
dataobjectUpdated role data
↳ idstringRole ID
↳ namestringRole name
↳ colornumberRole color

Discord Delete Role

Delete a role from a Discord server

Inputs and outputs

Input

ParameterTypeRequiredDescription
botTokenstringYesThe bot token for authentication
serverIdstringYesThe Discord server ID (guild ID), e.g., 123456789012345678
roleIdstringYesThe role ID to delete, e.g., 123456789012345678

Output

ParameterTypeDescription
messagestringSuccess or error message

Discord Assign Role

Assign a role to a member in a Discord server

Inputs and outputs

Input

ParameterTypeRequiredDescription
botTokenstringYesThe bot token for authentication
serverIdstringYesThe Discord server ID (guild ID), e.g., 123456789012345678
userIdstringYesThe user ID to assign the role to, e.g., 123456789012345678
roleIdstringYesThe role ID to assign, e.g., 123456789012345678

Output

ParameterTypeDescription
messagestringSuccess or error message

Discord Remove Role

Remove a role from a member in a Discord server

Inputs and outputs

Input

ParameterTypeRequiredDescription
botTokenstringYesThe bot token for authentication
serverIdstringYesThe Discord server ID (guild ID), e.g., 123456789012345678
userIdstringYesThe user ID to remove the role from, e.g., 123456789012345678
roleIdstringYesThe role ID to remove, e.g., 123456789012345678

Output

ParameterTypeDescription
messagestringSuccess or error message

Discord List Roles

List all roles in a Discord server

Inputs and outputs

Input

ParameterTypeRequiredDescription
botTokenstringYesThe bot token for authentication
serverIdstringYesThe Discord server ID (guild ID), e.g., 123456789012345678

Output

ParameterTypeDescription
messagestringSuccess or error message
dataarrayArray of Discord roles in the server
↳ idstringRole ID
↳ namestringRole name
↳ colornumberRole color
↳ hoistbooleanWhether role is hoisted
↳ positionnumberRole position in the hierarchy
↳ mentionablebooleanWhether role is mentionable

Discord Kick Member

Kick a member from a Discord server

Inputs and outputs

Input

ParameterTypeRequiredDescription
botTokenstringYesThe bot token for authentication
serverIdstringYesThe Discord server ID (guild ID), e.g., 123456789012345678
userIdstringYesThe user ID to kick, e.g., 123456789012345678
reasonstringNoReason for kicking the member

Output

ParameterTypeDescription
messagestringSuccess or error message

Discord Ban Member

Ban a member from a Discord server

Inputs and outputs

Input

ParameterTypeRequiredDescription
botTokenstringYesThe bot token for authentication
serverIdstringYesThe Discord server ID (guild ID), e.g., 123456789012345678
userIdstringYesThe user ID to ban, e.g., 123456789012345678
reasonstringNoReason for banning the member
deleteMessageSecondsnumberNoSeconds of message history to delete, 0-604800 (7 days)

Output

ParameterTypeDescription
messagestringSuccess or error message

Discord Unban Member

Unban a member from a Discord server

Inputs and outputs

Input

ParameterTypeRequiredDescription
botTokenstringYesThe bot token for authentication
serverIdstringYesThe Discord server ID (guild ID), e.g., 123456789012345678
userIdstringYesThe user ID to unban, e.g., 123456789012345678
reasonstringNoReason for unbanning the member

Output

ParameterTypeDescription
messagestringSuccess or error message

Discord Get Member

Get information about a member in a Discord server

Inputs and outputs

Input

ParameterTypeRequiredDescription
botTokenstringYesThe bot token for authentication
serverIdstringYesThe Discord server ID (guild ID), e.g., 123456789012345678
userIdstringYesThe user ID to retrieve, e.g., 123456789012345678

Output

ParameterTypeDescription
messagestringSuccess or error message
dataobjectMember data
↳ userobjectUser information
↳ idstringUser ID
↳ usernamestringUsername
↳ avatarstringAvatar hash
↳ nickstringServer nickname
↳ rolesarrayArray of role IDs
↳ joined_atstringWhen the member joined

Discord Update Member

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

Inputs and outputs

Input

ParameterTypeRequiredDescription
botTokenstringYesThe bot token for authentication
serverIdstringYesThe Discord server ID (guild ID), e.g., 123456789012345678
userIdstringYesThe user ID to update, e.g., 123456789012345678
nickstringNoNew nickname for the member (null to remove)
mutebooleanNoWhether to mute the member in voice channels
deafbooleanNoWhether to deafen the member in voice channels

Output

ParameterTypeDescription
messagestringSuccess or error message
dataobjectUpdated member data
↳ nickstringServer nickname
↳ mutebooleanVoice mute status
↳ deafbooleanVoice deaf status

Discord Create Invite

Create an invite link for a Discord channel

Inputs and outputs

Input

ParameterTypeRequiredDescription
botTokenstringYesThe bot token for authentication
channelIdstringYesThe Discord channel ID to create an invite for, e.g., 123456789012345678
maxAgenumberNoDuration of invite in seconds (0 = never expires, default 86400)
maxUsesnumberNoMax number of uses (0 = unlimited, default 0)
temporarybooleanNoWhether invite grants temporary membership
serverIdstringYesThe Discord server ID (guild ID), e.g., 123456789012345678

Output

ParameterTypeDescription
messagestringSuccess or error message
dataobjectCreated invite data
↳ codestringInvite code
↳ urlstringFull invite URL
↳ max_agenumberMax age in seconds
↳ max_usesnumberMax uses
↳ temporarybooleanWhether temporary

Discord Get Invite

Get information about a Discord invite

Inputs and outputs

Input

ParameterTypeRequiredDescription
botTokenstringYesThe bot token for authentication
inviteCodestringYesThe invite code to retrieve
serverIdstringYesThe Discord server ID (guild ID), e.g., 123456789012345678

Output

ParameterTypeDescription
messagestringSuccess or error message
dataobjectInvite data
↳ codestringInvite code
↳ guildobjectServer information
↳ channelobjectChannel information
↳ approximate_member_countnumberApproximate member count
↳ approximate_presence_countnumberApproximate online count

Discord Delete Invite

Delete a Discord invite

Inputs and outputs

Input

ParameterTypeRequiredDescription
botTokenstringYesThe bot token for authentication
inviteCodestringYesThe invite code to delete
serverIdstringYesThe Discord server ID (guild ID), e.g., 123456789012345678

Output

ParameterTypeDescription
messagestringSuccess or error message

Discord Create Webhook

Create a webhook in a Discord channel

Inputs and outputs

Input

ParameterTypeRequiredDescription
botTokenstringYesThe bot token for authentication
channelIdstringYesThe Discord channel ID to create the webhook in, e.g., 123456789012345678
namestringYesName of the webhook (1-80 characters)
serverIdstringYesThe Discord server ID (guild ID), e.g., 123456789012345678

Output

ParameterTypeDescription
messagestringSuccess or error message
dataobjectCreated webhook data
↳ idstringWebhook ID
↳ namestringWebhook name
↳ tokenstringWebhook token
↳ urlstringWebhook URL
↳ channel_idstringChannel ID

Discord Execute Webhook

Execute a Discord webhook to send a message

Inputs and outputs

Input

ParameterTypeRequiredDescription
webhookIdstringYesThe webhook ID, e.g., 123456789012345678
webhookTokenstringYesThe webhook token
contentstringYesThe message content to send
usernamestringNoOverride the default username of the webhook
serverIdstringYesThe Discord server ID (guild ID), e.g., 123456789012345678

Output

ParameterTypeDescription
messagestringSuccess or error message
dataobjectMessage sent via webhook
↳ idstringMessage ID
↳ contentstringMessage content
↳ channel_idstringChannel ID
↳ timestampstringMessage timestamp

Discord Get Webhook

Get information about a Discord webhook

Inputs and outputs

Input

ParameterTypeRequiredDescription
botTokenstringYesThe bot token for authentication
webhookIdstringYesThe webhook ID to retrieve, e.g., 123456789012345678
serverIdstringYesThe Discord server ID (guild ID), e.g., 123456789012345678

Output

ParameterTypeDescription
messagestringSuccess or error message
dataobjectWebhook data
↳ idstringWebhook ID
↳ namestringWebhook name
↳ channel_idstringChannel ID
↳ guild_idstringServer ID
↳ tokenstringWebhook token

Discord Delete Webhook

Delete a Discord webhook

Inputs and outputs

Input

ParameterTypeRequiredDescription
botTokenstringYesThe bot token for authentication
webhookIdstringYesThe webhook ID to delete, e.g., 123456789012345678
serverIdstringYesThe Discord server ID (guild ID), e.g., 123456789012345678

Output

ParameterTypeDescription
messagestringSuccess or error message
Was this helpful?
Suggest an edit