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 — a link is created in the workspace.
• link.expired — a link reached its expiry date.
• link.cap_reached — a link hit its click cap.
• link.broken — the broken-link monitor found a destination that no longer works.
• domain.verified and domain.ssl_failed — custom domain verification and certificate problems.
• usage.threshold_80 and usage.threshold_100 — the workspace used 80% or 100% of its plan quota.

The full list of event types is in the webhooks guide.

Each Discord message arrives as an embed with the event type, a title, the event fields, and a color by severity (green for created, blue for updated, red for failures).

The embed payload looks like this:

{
  "username": "Elido",
  "embeds": [
    {
      "title": "Link expired",
      "description": "elido.me/spring-2026",
      "color": 15680580
    }
  ]
}

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 — Open Configure events and switch off the events you do not need. Discord also rate-limits webhooks to about 30 messages per minute per channel, so use a dedicated alerts channel.