Skip to content
← Back to documentation
Technical Reference

Discord

Instant messaging and VoIP social platform

CategoryCommunication
Authenticationcustom
Version0.6.0
Published scopes0 published scopes
Last updatedSeptember 19, 2026

Overview

Connect Discord with Flows360

Instant messaging and VoIP social platform

Use the Discord connector to include its declared actions and events in Flows360 workflows without duplicating the integration logic inside each consuming system. This pinned connector version currently exposes 61 actions and 2 triggers.

Available actions

  • Send Message with Bot
  • Send Message Webhook
  • Request Approval in a Channel
  • Add role to member
  • Remove role from member
  • Remove member from guild
  • List guild members
  • Rename channel
  • Plus 53 additional declared actions.

Available triggers

  • New message
  • New Member

The capability list above is generated from the exact reviewed connector package so the public description stays aligned with the version Flows360 operates.

Technical guide

Technical reference

Package identity

  • Connector: Discord
  • Package: @activepieces/piece-discord@0.6.0
  • Exact artifact digest: sha256:3af26afc210edfc5c0e82c1dcb4cd0233594b7c880a1e8c53a07d650e407e390
  • Runtime: Activepieces-compatible deterministic worker
  • Source: the exact reviewed Activepieces source

Authentication

SECRET TEXT. Connection values are tenant-specific and remain in the consuming Studio instance; CDK stores definitions and field metadata, not customer credential values.

Action contracts

  • Send Message with Bot (sendMessageWithBot), Send messages via bot to any channel or thread you want, with an optional file attachment. Classification: read.
  • Send Message Webhook (send_message_webhook), Send a discord message via webhook Classification: read.
  • Request Approval in a Channel (request_approval_message), send a message to a channel asking for approval and wait for a response Classification: read.
  • Add role to member (add_role_to_member), Add Guild Member Role Classification: read.
  • Remove role from member (remove_role_from_member), Remove Guild Member Role Classification: read.
  • Remove member from guild (remove_member_from_guild), Remove Guild Member Classification: read.
  • List guild members (list_guild_members), List Guild Members Classification: read.
  • Rename channel (rename_channel), rename a channel Classification: read.
  • Create channel (create_channel), create a channel Classification: read.
  • Delete channel (delete_channel), delete a channel Classification: read.
  • Find channel (find_channel), find a channel by name Classification: read.
  • Remove ban from user (remove_ban_from_user), Removes the guild ban from a user Classification: read.
  • Create guild role (createGuildRole), Creates a new role on the specified guild Classification: read.
  • Delete guild role (deleteGuildRole), Deletes the specified role from the specified guild Classification: read.
  • Ban guild member (ban_guild_member), Bans a guild member Classification: read.
  • Send Message (discord_send_message), Post a message to a Discord channel or thread. Classification: read.
  • Create Channel (discord_create_channel), Create a new channel in a guild. Classification: read.
  • Delete Channel (discord_delete_channel), Permanently delete a channel by ID. Classification: read.
  • Rename Channel (discord_rename_channel), Change the name of an existing channel. Classification: read.
  • Find Channel (discord_find_channel), Resolve a channel name to its ID within a guild. Classification: read.
  • Add Role to Member (discord_add_role), Assign a role to a guild member. Classification: read.
  • Remove Role from Member (discord_remove_role), Remove a role from a guild member. Classification: read.
  • Create Role (discord_create_role), Create a new role in a guild. Classification: read.
  • Delete Role (discord_delete_role), Permanently delete a role from a guild. Classification: read.
  • Find Member (discord_find_member), Search guild members by username/nickname prefix. Classification: read.
  • List Messages (discord_list_messages), Read recent messages from a channel. Classification: read.
  • Edit Message (discord_edit_message), Edit the content of one of the bot's own messages. Classification: read.
  • Delete Message (discord_delete_message), Delete a single message from a channel. Classification: read.
  • Bulk Delete Messages (discord_bulk_delete_messages), Delete 2-100 recent messages from a channel in one call. Classification: read.
  • Pin Message (discord_pin_message), Pin a message in a channel. Classification: read.
  • Unpin Message (discord_unpin_message), Remove a pinned message from a channel. Classification: read.
  • List Pinned Messages (discord_list_pinned_messages), List the pinned messages in a channel. Classification: read.
  • Add Reaction (discord_add_reaction), Add the bot's reaction emoji to a message. Classification: read.
  • Remove Own Reaction (discord_remove_reaction), Remove the bot's own reaction from a message. Classification: read.
  • Remove User Reaction (discord_remove_user_reaction), Remove another user's reaction from a message (moderation). Classification: read.
  • List Reactions (discord_list_reactions), List users who reacted to a message with an emoji. Classification: read.
  • Clear All Reactions (discord_clear_reactions), Remove all reactions from a message. Classification: read.
  • Create Thread from Message (discord_create_thread_from_message), Start a thread attached to an existing message. Classification: read.
  • Create Thread (discord_create_thread), Create a standalone thread (or forum post) in a channel. Classification: read.
  • List Active Threads (discord_list_active_threads), List all active threads in a guild. Classification: read.
  • List Archived Threads (discord_list_archived_threads), List public archived threads in a channel. Classification: read.
  • Join Thread (discord_join_thread), Have the bot join a thread. Classification: read.
  • Leave Thread (discord_leave_thread), Have the bot leave a thread. Classification: read.
  • Add Thread Member (discord_add_thread_member), Add a user to a thread. Classification: read.
  • List Channels (discord_list_channels), Enumerate all channels in a guild. Classification: read.
  • Get Channel (discord_get_channel), Fetch the details of a single channel. Classification: read.
  • Get Member (discord_get_member), Fetch a single guild member by user ID. Classification: read.
  • List Bans (discord_list_bans), List the banned users of a guild. Classification: read.
  • List Roles (discord_list_roles), List the roles of a guild. Classification: read.
  • Update Role (discord_update_role), Update a role's name, color, hoist, or mentionable settings. Classification: read.
  • Get Guild (discord_get_guild), Fetch metadata about a guild. Classification: read.
  • List Emojis (discord_list_emojis), List a guild's custom emojis. Classification: read.
  • Create Scheduled Event (discord_create_scheduled_event), Create a scheduled event in a guild. Classification: read.
  • List Scheduled Events (discord_list_scheduled_events), List the scheduled events of a guild. Classification: read.
  • Update Scheduled Event (discord_update_scheduled_event), Edit, start, or cancel a scheduled event. Classification: read.
  • Delete Scheduled Event (discord_delete_scheduled_event), Delete a scheduled event. Classification: read.
  • List Invites (discord_list_invites), List the active invites of a guild. Classification: read.
  • Revoke Invite (discord_revoke_invite), Delete (revoke) an invite by its code. Classification: read.
  • Create DM Channel (discord_create_dm), Open (or fetch) a direct-message channel with a user. Classification: read.
  • Get User (discord_get_user), Fetch a global Discord user object by ID. Classification: read.
  • Custom API Call (custom_api_call), Make a custom API call to a specific endpoint Classification: read.

Trigger contracts

  • New message, polling.
  • New Member, polling.

Verification

Deterministic execution evidence is recorded for the pinned artifact, including 1 exercised action entrypoint and 0 exercised trigger entrypoints.

Capability summary

Authenticationcustom
Supported objects63
Supported actionsNot published
Triggers2

Authentication

Authentication method: custom

Authentication profiles

connection · custom
  • Bot Token Required · protected credential

Supported objects

ObjectReadWriteNotes
Send Message with Bot Yes No Send messages via bot to any channel or thread you want, with an optional file attachment.
Send Message Webhook Yes No Send a discord message via webhook
Request Approval in a Channel Yes No send a message to a channel asking for approval and wait for a response
Add role to member Yes No Add Guild Member Role
Remove role from member Yes No Remove Guild Member Role
Remove member from guild Yes No Remove Guild Member
List guild members Yes No List Guild Members
Rename channel Yes No rename a channel
Create channel Yes No create a channel
Delete channel Yes No delete a channel
Find channel Yes No find a channel by name
Remove ban from user Yes No Removes the guild ban from a user
Create guild role Yes No Creates a new role on the specified guild
Delete guild role Yes No Deletes the specified role from the specified guild
Ban guild member Yes No Bans a guild member
Send Message Yes No Post a message to a Discord channel or thread.
Create Channel Yes No Create a new channel in a guild.
Delete Channel Yes No Permanently delete a channel by ID.
Rename Channel Yes No Change the name of an existing channel.
Find Channel Yes No Resolve a channel name to its ID within a guild.
Add Role to Member Yes No Assign a role to a guild member.
Remove Role from Member Yes No Remove a role from a guild member.
Create Role Yes No Create a new role in a guild.
Delete Role Yes No Permanently delete a role from a guild.
Find Member Yes No Search guild members by username/nickname prefix.
List Messages Yes No Read recent messages from a channel.
Edit Message Yes No Edit the content of one of the bot's own messages.
Delete Message Yes No Delete a single message from a channel.
Bulk Delete Messages Yes No Delete 2-100 recent messages from a channel in one call.
Pin Message Yes No Pin a message in a channel.
Unpin Message Yes No Remove a pinned message from a channel.
List Pinned Messages Yes No List the pinned messages in a channel.
Add Reaction Yes No Add the bot's reaction emoji to a message.
Remove Own Reaction Yes No Remove the bot's own reaction from a message.
Remove User Reaction Yes No Remove another user's reaction from a message (moderation).
List Reactions Yes No List users who reacted to a message with an emoji.
Clear All Reactions Yes No Remove all reactions from a message.
Create Thread from Message Yes No Start a thread attached to an existing message.
Create Thread Yes No Create a standalone thread (or forum post) in a channel.
List Active Threads Yes No List all active threads in a guild.
List Archived Threads Yes No List public archived threads in a channel.
Join Thread Yes No Have the bot join a thread.
Leave Thread Yes No Have the bot leave a thread.
Add Thread Member Yes No Add a user to a thread.
List Channels Yes No Enumerate all channels in a guild.
Get Channel Yes No Fetch the details of a single channel.
Get Member Yes No Fetch a single guild member by user ID.
List Bans Yes No List the banned users of a guild.
List Roles Yes No List the roles of a guild.
Update Role Yes No Update a role's name, color, hoist, or mentionable settings.
Get Guild Yes No Fetch metadata about a guild.
List Emojis Yes No List a guild's custom emojis.
Create Scheduled Event Yes No Create a scheduled event in a guild.
List Scheduled Events Yes No List the scheduled events of a guild.
Update Scheduled Event Yes No Edit, start, or cancel a scheduled event.
Delete Scheduled Event Yes No Delete a scheduled event.
List Invites Yes No List the active invites of a guild.
Revoke Invite Yes No Delete (revoke) an invite by its code.
Create DM Channel Yes No Open (or fetch) a direct-message channel with a user.
Get User Yes No Fetch a global Discord user object by ID.
Custom API Call Yes No Make a custom API call to a specific endpoint
New message Yes No polling trigger declared by the pinned package.
New Member Yes No polling trigger declared by the pinned package.

Triggers

New message · Poll

Triggers when a message is sent in a channel

Inputs

  • limit · number
  • channel · string
New Member · Poll

Triggers when a new member joins a guild

Inputs

  • limit · number
  • guildId · string

Setup

Setup

  1. Add the Discord connector to the workflow in the target Flows360 Studio instance.
  2. Create or select the tenant-specific connection required by the connector. Connection secrets remain in the Studio connection boundary and are not copied into CDK documentation.
  3. Provide the connection fields declared by the pinned package:
  • No provider credential fields are declared by the pinned package.
  1. Select the required action or trigger and complete its declared input fields. Required and optional inputs are defined by the exact package schema.
  2. Test the workflow in the appropriate environment before enabling production scheduling or event delivery.

Limitations

Limitations and operational notes

  • This content describes @activepieces/piece-discord@0.6.0; provider behaviour can change independently and should be revalidated when the provider or connector version changes.
  • Only the 61 actions and 2 triggers declared by this pinned package are represented here.
  • Tenant credentials and connection values are not stored in the public connector record.
  • Provider-side permissions, account entitlements, quotas and rate limits remain subject to the connected provider account and are not inferred when the package does not declare them.
  • Deterministic execution evidence is recorded for the pinned artifact, including 1 exercised action entrypoint and 0 exercised trigger entrypoints.

Troubleshooting

Why canu2019t the connector authenticate?

Check the tenant connection in Studio and confirm every required Discord connection field is present. Re-authorise OAuth-based connections if the provider token or consent has expired. Do not place credential values in CDK content or logs.

Why is an action or trigger unavailable?

Confirm that the workflow is using @activepieces/piece-discord@0.6.0 and compare the requested capability with the declared action and trigger list for this version. A capability that is not declared by the pinned package should not be presented as supported.

What should I check after a provider-side change?

Revalidate authentication, required fields, action/trigger behaviour and provider documentation before publishing refreshed connector content or moving a new package version into production.