Call a webhook from a trigger

Available on: Starter, Growth, Pro, Enterprise.

Use a webhook when another system should know about a ticket, for example to post urgent tickets to your on-call tool.

1. Create the webhook

1. Open Admin Center, Integrations, Webhooks and choose New webhook.
2. Enter a Name, the Endpoint URL and the Method (POST, PUT or PATCH).
3. Under Subscriptions, tick Triggers and automations. Without it the webhook cannot be picked in a rule.
4. Choose Create webhook.

See Create a webhook for the other options.

2. Use it in a rule

1. Open the trigger or automation.
2. Add the action Notify webhook and pick the webhook.
3. Save the rule.

ChaosDesk then sends the standard ChaosDesk event payload, signed like every other delivery. Its type is trigger or automation, and event.rule names the rule that called it, so the receiver can tell rule calls apart:

{"type": "trigger", "subject": "ticket:1042", "detail": {"id": "…", "status": "open", "priority": "urgent"}, "event": {"rule": {"type": "trigger", "id": "…"}}}

The payload carries ids and the ticket's current values, never the subject text or comments. A Custom JSON body on the webhook shapes its event subscriptions, not the calls rules make; to send your own JSON from a rule, set the body on the action through the API.

Check that it works

Open the webhook's Delivery log under Admin Center, Integrations, Webhooks. Each call shows its status (Delivered, Retrying or Failed), the response and the number of attempts. Failed calls are retried after 1 minute, 5 minutes, 30 minutes, 2 hours, 6 hours and 12 hours. You can Replay a delivery.

If you delete a webhook, rules that call it log an error instead.

Related

• Create a webhook
• Verify webhook signatures
• Use placeholders in macros and rules