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.