Unbind

Webhooks

Get notified in Discord, Slack, Telegram or your own endpoint when something happens.

A webhook sends a message to a URL when something happens in Unbind, like a deployment failing.

Add a webhook

Webhooks exist at two levels, and each level has its own events:

WhereEvents
Team > Settings > WebhooksProject created, updated, deleted
Project > Settings > WebhooksService created, updated, deleted. Deployment queued, building, succeeded, failed, cancelled

Pick the events, paste the URL and press Create Webhook.

Most people want one project webhook for Deployment Failed, pointed at the team chat.

Discord, Slack and Telegram

Paste a webhook URL from one of these and Unbind formats the message for it. Nothing else to configure.

  • Discord: channel settings > Integrations > Webhooks.
  • Slack: create an incoming webhook.
  • Telegram: create a bot with @BotFather, then use https://api.telegram.org/bot<token>/sendMessage?chat_id=<chat id>.

Your own endpoint

Any other URL receives a POST with a JSON body:

{
  "level": "failed",
  "event": "deployment.failed",
  "data": {
    "title": "Deployment Failed",
    "url": "https://unbind.example.com/...",
    "description": "...",
    "fields": [{ "name": "Service", "value": "API" }]
  }
}

level is one of info, warning, error, queued, building, succeeded or failed. Answer with status 200. Anything else counts as a failure.

Good to know

  • Treat the URL as a secret. Anyone who has it can post to your channel. The webhooks page hides it except for the host and the last few characters. Press the eye button on a webhook to see the full URL. Only editors of the team or project get it; viewers see the webhook without its URL.
  • There is no test button. Subscribe to Service Updated, change something small and check that the message arrives.
  • API keys and connected apps see a blank URL unless they have the read_webhook_urls privilege and their owner is an editor there.

On this page