Connect Discord to Elido

Elido posts to Discord via an incoming webhook — no bot account, no server permissions beyond creating the webhook. You control exactly which channel receives messages.

Before you start

You need Manage Webhooks permission in the Discord server. A server admin has this by default. If you're not an admin, ask one to create the webhook for you and copy the URL.

Create the Discord webhook

1. In Discord, right-click the channel you want alerts in and click Edit Channel.
2. Go to Integrations → Webhooks → New Webhook.
3. Give it a name ("Elido") and optionally an avatar.
4. Click Copy Webhook URL. It looks like https://discord.com/api/webhooks/1234.../AbcD....

Add the webhook in Elido

1. Open Settings → Notifications → Add channel → Discord.
2. Paste the webhook URL.
3. Click Save. Elido posts a test message immediately — you should see it in Discord within 2–3 seconds.

Choose which events to forward

After saving, click Configure events. You can enable or disable each of the following per channel:

• link.created — fires when any link is created in the workspace.
• link.clicked — fires on every click (high volume on busy links; use a threshold instead).
• threshold.exceeded — fires once when a link crosses your defined click count.
• scan.failed — fires when our URL scanner flags a destination.

Each Discord message arrives as an embed with the link slug, event type, click count, and a deep link to the analytics view.

The embed payload looks like this:

{
  "username": "Elido",
  "embeds": [
    {
      "title": "elido.me/spring-2026 hit 1,000 clicks",
      "url": "https://app.elido.app/dashboard/links/42",
      "color": 6586590
    }
  ]
}

Remove the integration

Delete the webhook in Discord (Channel Settings → Integrations → Webhooks → Delete), or remove the channel in Elido (Settings → Notifications → Discord → Remove). Either action stops delivery.

Troubleshooting

Test message didn't arrive — Paste the webhook URL into a browser address bar. Discord returns {"message": "401: Unauthorized"} for invalid URLs and the word "OK" for valid ones. If the URL is valid but no message arrived, check the channel's notification settings — Discord can suppress messages from bots at the server or channel level.

Messages stopped after a few days — Discord silently invalidates webhooks if they 4xx repeatedly (e.g. because the channel was deleted). Create a new webhook and re-add it in Elido.

"Unknown Webhook" error in the Elido delivery log — The webhook was deleted in Discord. Create a fresh one.

Getting too many messages — Switch from link.clicked to threshold.exceeded with a higher number. A link with 10,000 clicks a day will flood any channel if you forward every click.