Skip to main content
Documentation/Forms/Actions & Integrations/Discord Integration

Discord Integration

The Discord action sends form submissions to a channel through an incoming webhook.

Create a Channel Webhook

  1. In Discord, open the server’s Server Settings > Integrations.
  2. Create a webhook using Create Webhook, give it a name, and select its destination text channel.
  3. Click Copy Webhook URL. See Discord’s webhook setup guide.

Save the Shared Webhook

  1. In WordPress, open Breakdance > Settings > API Keys.
  2. Paste the URL into Discord Webhook URL and click Save Changes.
Breakdance API Keys settings showing Discord Webhook URL with its value concealed
Breakdance API Keys settings showing Discord Webhook URL with its value concealed

The webhook sends to the text channel chosen in Discord. Use another webhook to send to a different channel.

Connect a Channel

  1. Select Discord under Actions > Actions After Submission in the Content tab, then configure Use Discord Webhook. Default uses site credentials; Custom uses this form’s connection. After correcting credentials, click Reload Key.
  2. Configure the message and save.
Discord action settings
Discord action settings

Message Settings

  • Use Discord Webhook — Connection.
  • Bot Name — Sender name.
  • Title, Description — Message content.
  • Message Icon, Main Image — Icon and embedded image.
  • Include form data, Include timestamp — Submitted fields and time.
  • Border color — Embed accent.

Supported controls accept field-ID variables such as {name}. Disable Include form data to send only chosen values.

Enable Run Action Conditionally and add Conditions to run this action only when all configured field comparisons match.