PulsAPI Logo
PulsAPI Docs

Discord Integration

Post PulsAPI status alerts to any Discord text channel using a webhook.

Discord Integration

Connect PulsAPI to your Discord server to receive status change alerts in any text channel. Setup takes under two minutes and requires no bots or Discord developer accounts.

Discord integration is available on Pro plans and above.


Setup

Step 1 — Create a Discord Webhook

  1. Open Discord and go to the server where you want to receive alerts.
  2. Right-click the target text channel and select Edit Channel.
  3. Go to Integrations → Webhooks and click New Webhook.
  4. Give the webhook a name (e.g., "PulsAPI") and optionally upload the PulsAPI logo as the avatar.
  5. Click Copy Webhook URL — it starts with https://discord.com/api/webhooks/....
  6. Click Save.

Step 2 — Connect in PulsAPI

  1. Go to Settings → Integrations.
  2. Click Connect under Discord.
  3. Paste the Webhook URL in the Discord Webhook URL field.
  4. Give the integration a label (e.g., "Discord — #ops-alerts").
  5. Click Test — a test message should appear in your Discord channel within seconds.
  6. Click Save.

What the alert looks like

Discord alerts from PulsAPI are formatted messages that include:

  • Service name and status change (e.g., Stripe: Operational → Degraded Performance)
  • Severity level
  • Timestamp
  • Link to the PulsAPI service detail page

Tips

Create a dedicated #pulsapi-alerts channel in your server to keep status notifications separate from team conversation. You can mute this channel on mobile while keeping desktop notifications active.


Troubleshooting

Test message not appearing?

  • Confirm the webhook URL is complete and correct
  • Ensure the target channel still exists and the webhook hasn't been deleted in Discord
  • Check Discord's server settings to ensure webhooks are not blocked

Alerts stopped arriving?

  • Discord webhooks are invalidated if the channel is deleted or the webhook is manually removed. Create a new webhook in Discord and update the integration in PulsAPI Settings → Integrations.

On this page