Discord

Last updated on November 19, 2026

The Discord integration posts a message to a Discord channel whenever a workflow fires. It relies on Discord webhooks, so you do not need to host a bot or assign permissions to a service account.

Connect Discord

Connecting Discord takes three steps that you complete in Discord first and then in TofuPilot.

In Discord, open the target channel and navigate to Settings > Integrations > Webhooks > New Webhook.

Name the webhook (for example, TofuPilot), pick an avatar, and copy the webhook URL it generates.

In TofuPilot, open a workflow and add a Send Discord Message action, then paste the webhook URL into the configuration panel.

Fields

The action takes two required fields and two optional overrides that you can use to customize how the message appears in the channel.

FieldRequiredPurpose
Webhook URLYesDiscord webhook URL. The channel is encoded in the URL.
MessageYesPlain text. Supports {{variable}} interpolation. Discord renders markdown.
UsernameNoOverride the webhook's display name.
Avatar URLNoOverride the webhook's avatar.

Only mentions you type in the message itself notify. A value inserted through {{variable}} cannot ping @everyone, @here, or a user or role the message does not already mention. To mention someone from a variable, write the mention around it, such as <@{{trigger.owner_id}}> for a user or <@&{{trigger.role_id}}> for a role.

If the username contains discord or clyde, which Discord forbids, or is built from a variable that has no value, the message is posted under the webhook's own name instead.

Webhook URL visibility

The webhook URL is a credential: anyone who has it can post to the channel. Members with the Viewer role never see its token, and execution logs hide it.

Limits

Discord and TofuPilot both apply limits that you should be aware of when designing high-volume workflows.

  • Discord enforces a webhook rate limit of 30 messages per 60 seconds per channel. When Discord answers with a rate limit, TofuPilot waits for the delay Discord asks for and retries up to 3 times before the step fails.
  • Message body: 2,000 characters max. Longer messages are cut at the limit.

How is this guide?

On this page