Skip to main content
Connect DevHelm to Discord to receive incident notifications in your server channels. Plan requirement: Starter or above

Setup

1

Create a Discord webhook

  1. In Discord, right-click a channel → Edit ChannelIntegrationsWebhooks
  2. Click New Webhook and name it (e.g., “DevHelm Alerts”)
  3. Copy the webhook URL
2

Create the alert channel in DevHelm

devhelm alert-channels create \
  --name "Discord Alerts" \
  --type DISCORD \
  --webhook-url "https://discord.com/api/webhooks/..."
3

Test the channel

devhelm alert-channels test <channel-id>

Configuration

FieldDescriptionRequired
webhookUrlDiscord webhook URLYes
mentionRoleIdDiscord role ID to mention in notificationsNo

Finding a role ID

To mention a role in notifications, you need the role ID:
  1. Enable Developer Mode in Discord (User Settings → Advanced)
  2. Right-click the role in Server Settings → Roles → Copy Role ID

Troubleshooting

The URL must start with https://discord.com/api/webhooks/ or https://discordapp.com/api/webhooks/.
  1. Verify the webhook hasn’t been deleted in Discord channel settings
  2. Check that the bot has permission to post in the channel
  3. Run devhelm alert-channels test <id>