Mattering Automations Discord integration

Get the bot user the connector's token belongs to. Takes no parameters, so it doubles as the connector's auth check.

Get one channel or thread by id.

Get a single message by id, including its reactions and embeds.

Get a server by id, including its roles and features.

Check whether one user is banned. Returns the ban with its reason, or 404 when the user is not banned.

Get one member's server profile: nickname, roles, join date and timeout state.

Get the public preview of a server. Works when the bot is a member, or for any server that has Discovery enabled.

Get one role by id.

Get a Discord user by id. Returns the global user, not their server profile.

Get one webhook by id, using the bot token. Requires Manage Webhooks.

List every active (not archived) thread in a server that the bot can see.

List a channel's public archived threads, newest archive first. Requires Read Message History.

List the servers the bot is a member of, as partial guild objects.

List the invites that point at a channel. Requires Manage Channels.

Read messages from a channel, newest first. around, before and after are mutually exclusive, pass only one.

List a channel's webhooks. The response includes each webhook's token, so treat this node's output as secret.

List a channel's pinned messages, newest pin first. Page with before, using the last pinned_at value you received.

List the users who reacted to a message with one emoji.

List the users banned from a server. Requires Ban Members.

List every channel in a server. Threads are not included.

List a server's custom emojis. Use the returned name and id as name:id when adding a reaction.

List a server's members, ordered by user id. Requires the Server Members privileged intent, which you enable on the app's Bot page.

List every role in a server, with its permission bitfield and position.

List every webhook in a server. The response includes webhook tokens, so treat this node's output as secret.

List the members of a thread. Needs the Server Members privileged intent. Set with_member to true to get full member objects and paginated results.

Find server members whose username or nickname starts with a string.

Search a server's message history. Needs the Message Content privileged intent enabled on the app. An unindexed server answers 202 with a retry_after instead of results.

Add a user to a thread. The bot must be able to send messages in it.

React to a message as the bot. Needs Read Message History, plus Add Reactions when nobody has used that emoji on the message yet.

Give one role to a member, leaving their other roles alone. Requires Manage Roles, and the bot's own highest role must sit above the role being granted.

DESTRUCTIVE: ban a user from the server and optionally delete their recent messages. Requires Ban Members. Reversible only by an explicit unban, and deleted messages do not come back.

DESTRUCTIVE: permanently delete 2 to 100 messages in one call. Guild channels only, requires Manage Messages, and Discord rejects the whole batch if any message is older than 2 weeks or repeated. This cannot be undone.

DESTRUCTIVE: remove every reaction from a message, from every user and every emoji at once. Requires Manage Messages and cannot be undone.

DESTRUCTIVE: remove every user's reaction of one emoji from a message. Requires Manage Messages and cannot be undone.

Create a channel in a server. Requires the Manage Channels permission.

Create an invite link for a channel. Requires the Create Invite permission. Every field is optional; the defaults give a 24 hour, unlimited-use invite.

Create a role. Every field is optional; with none set you get a role named new role with the same permissions as everyone.

Create a webhook on a channel and return it with its token. Requires Manage Webhooks. Store the returned token as a secret.

DESTRUCTIVE: permanently delete a channel and every message in it. Deleting a category does not delete its child channels. This cannot be undone.

DESTRUCTIVE: permanently delete one message. Deleting somebody else's message requires Manage Messages. This cannot be undone.

DESTRUCTIVE: delete a role. Every member loses it and every channel permission overwrite that referenced it goes with it. This cannot be undone.

DESTRUCTIVE: delete a webhook using the bot token. Anything still posting to that webhook URL breaks immediately, and the URL cannot be recovered.

DESTRUCTIVE: permanently delete a message this webhook sent. This cannot be undone.

Edit a message. Only the original author can change content, embeds and components. Every field is optional; sending content replaces the whole text.

Edit a message that this webhook previously sent. The webhook token authorizes the call, so no bot token is sent.

Add the bot to a thread. The thread must not be archived.

DESTRUCTIVE: remove a member from the server. They lose their roles and nickname, and can rejoin only with a new invite. Requires Kick Members.

Remove the bot from a thread.

Open (or reuse) a direct message channel with one user and return the channel. Feed the returned id into Discord: Send Message to DM someone.

Pin a message in a channel. Requires the Pin Messages permission.

Publish a message in an announcement channel so it reaches every server following that channel.

Remove the bot's own reaction from a message.

Remove a role or member permission overwrite from a channel, so the channel falls back to server defaults.

Remove a user from a thread. Requires Manage Threads on public threads.

Take one role away from a member, leaving their other roles alone.

Remove one specific user's reaction from a message. Requires Manage Messages.

Post a message to a channel, thread or DM channel. At least one of content, embeds, components or sticker_ids is required. File attachments are not supported by this node.

Post a message through a channel webhook URL, with a custom display name and avatar. The webhook token is the credential here, so no bot token is sent. Set wait to true if you need the created message back.

Set the permission overwrite for one role or member on a channel. Requires Manage Roles, and the bot can only grant permissions it already holds.

Start a thread that is not attached to a message. Set type to 11 for a public thread or 12 for a private one; Discord still defaults to private when type is omitted.

Start a thread hanging off an existing message. The new thread id equals the source message id, so a message can only ever have one thread. Does not work in forum or media channels.

Lift a ban so the user can rejoin with a fresh invite. Requires Ban Members.

Unpin a message. The message itself is untouched, only the pin is removed.

Update a channel or thread. Every field is optional, send only what should change. Thread-only fields (archived, locked, auto_archive_duration, applied_tags) are ignored on normal channels.

Update a role. Send only the fields that should change.

Update a member: nickname, their whole role list, voice state, or a timeout. Note that roles REPLACES the member's roles, it does not add to them; use Discord: Add Role to Member for that.