Setting Up Webhooks

Create and manage webhooks from the Settings page.

Creating a Webhook

1. Go to Settings in the sidebar.
2. Open the Webhooks tab.
3. Click Add Webhook.
4. Enter your endpoint URL (must be HTTPS).
5. Select which events to listen for.
6. Optionally add a label to describe what this webhook does.
7. Click Create.

Selecting Events

Choose one or more events for your webhook:

• Process run created — Triggers when someone starts a new instance.
• Process run completed — Triggers when all tasks in an instance are finished.
• Process step completed — Triggers when individual tasks are completed (requires per-task opt-in — see below).

Enabling Per-Task Webhooks

The process_step.completed event only fires for tasks where you’ve explicitly enabled it:

1. Open a process in the editor.
2. Click the three-dot menu (⋯) on the task you want to track.
3. Toggle Send webhook on completion on.

This gives you fine-grained control over which tasks send data to your external services.

Testing Your Webhook

Before relying on a webhook in production, send a test to verify your endpoint receives data correctly:

1. Go to Settings > Webhooks.
2. Click the three-dot menu on your webhook.
3. Select Test and choose an event type (or send a generic ping).

The test sends a sample payload with realistic example data to your endpoint. Check your endpoint’s logs to confirm it was received.

Managing Webhooks

From the Webhooks tab you can:

• Toggle on/off — Pause a webhook without deleting it using the toggle switch.
• Edit — Change the URL, events, or label.
• Delete — Permanently remove a webhook and its delivery logs.

Limits

• Maximum 5 webhooks per team.
• Endpoint URLs must use HTTPS.
• Webhooks that fail 10 times in a row are automatically disabled — see Delivery & Troubleshooting.