Webhooks push a JSON payload to an endpoint you control the moment something happens, instead of you having to poll the API for changes.
You can subscribe a webhook to any of these events:
- Link created – fires when a new short link is created on your account
- Link visited – fires on every click of your short links, with country, city, referrer, device and browser
- Monitor is down / Monitor is back up – fires when one of your uptime monitors changes status
Every request is signed with a secret unique to that webhook, sent in the X-Nobiscum-Signature header as an HMAC-SHA256 hash of the JSON body, so you can verify the request actually came from us before trusting it.
How to add a webhook
- Open Tools in the sidebar and click Webhooks.
- Click Add Webhook.
- Enter the URL that should receive the events and select which events you want to subscribe to.
- Save, then use Send Test Ping on the webhook to confirm your endpoint receives it.
Each webhook keeps a short delivery history (event and HTTP response code) so you can confirm your endpoint is actually receiving what you expect.