Skip to main content

Webhooks

A webhook sends an event from Jaah to a URL you own, as it happens: a task finished, a task is waiting for an answer, a pull request merged. Your system receives an HTTPS POST with a JSON body, signed with a secret only you and Jaah know, so it can trust the request came from Jaah. Use it to open a ticket when a task fails, post to your team's chat when a pull request merges, or start a deploy when work is done, without anyone watching the console.

Webhooks live under Settings › Integrations › Webhooks. Only your organization's Owners and Admins see them, and only while your plan includes webhooks.

Where webhooks fit​

The events a webhook sends come from tasks and the pull requests they open. A webhook carries them out to a program; notifications carry news to a person instead, in the console or on email, Slack or Telegram. An automation with a Webhook trigger works the other way round: another system calls Jaah, and Jaah files a task.

Pages in this section​

What each screen shows is in the console reference: Webhooks. The event types you can choose are listed in the event catalog. Every endpoint action is also a call to the Jaah API.