Skip to main content

Webhooks

Open Integrations & APIs → Webhooks for the selected workspace. The page shows endpoint counts and health, 24-hour delivery totals, success rate, an event catalog, and recent deliveries.

Create an endpoint​

  1. Select Add endpoint.
  2. Enter a name and HTTPS endpoint URL.
  3. Select one or more events from the live catalog. Selecting every current event stores *, which also subscribes to future catalog events.
  4. Create the endpoint and copy its signing secret immediately. The plaintext secret is shown once.

Manage endpoints​

Use Test fire on an active endpoint to create a test delivery. The row menu supports Pause/Resume, Rotate secret, Edit, and Delete. Editing changes the name, URL, and selected events. Rotating invalidates the prior secret and reveals the replacement once. Delete requires confirmation and removes the endpoint.

The table reports endpoint status, health, 24-hour deliveries, failures, and last-fired time. Health values implemented by the UI are Healthy, Paused, Disabled. Do not rely on older Degraded/Failing labels.

Deliveries​

Recent deliveries refreshes while the tab is visible and combines the latest deliveries across endpoints. Select a delivery to inspect its event type, test marker, status, HTTP response code, endpoint, and available request/response details. The current dashboard provides inspection; it does not expose a replay button.

Verify signatures with the endpoint secret using your server's raw request body, and make processing idempotent. Exact signature headers, retry timing, and event payloads should come from the live event catalog/reference or your received delivery rather than static examples.

Frequently asked questions​

Can I view a signing secret again?

No. Create or rotate the secret, copy it during the one-time reveal, and acknowledge that it is stored before closing.

How do I change an endpoint?

Open its row menu and choose Edit. You can change the name, URL, and events; use Pause when you need to stop deliveries temporarily.

Can I replay a delivery from the dashboard?

No replay action is implemented in the current delivery panel. Use Test fire for an active endpoint and inspect the resulting delivery.