<aside> 👋

We can help you set this up - please contact if struggling

</aside>

Webhooks let you send data from a workflow step to an external system when a specific event occurs.

Under “Notifications” in Workflows, you can add webhook’s that push data from a state.

How to configure a webhook

1. Go to Workflows → Notifications.

2. Click Add in the top-right corner.

3. Set Type to Webhook.

4. Select the step that should trigger the webhook.

5. Choose the state that triggers the webhook:

   • Active – triggers when the step is activated (not yet completed).
   • Done – triggers when the step is completed.
   • (Some other states are also available for special cases)

6. (Optional) “When”

   1. On state: Triggers momentarily on state change.
   2. After state: Defer execution by X days after the state change happens.
   3. Before state: (Only for bookings) Trigger X days before the booking date

7. Enter the Webhook URL, for example:

   https://example.com/webhook/installer

8. Define the payload using Handlebars templates.

   • NOTE: Payloads are not yet fully validated due to handlebars limitations.
   • Ensure the rendered output is valid JSON.

9. Configure request headers, including any required API tokens.

The payload requires handlebars syntax, so make sure to use {{ order.id }} , syntax. Also ensure that the variables are wrapped in string quotes – unless you explicitly want bool / numeric values.