Skip to main content

Webhooks

Organization Webhooks send selected organization events to a receiver URL. One endpoint can cover all Workspaces or a chosen subset, and the page shows its status and deliveries.

Before You Begin​

  • Have access to the Organization's Webhooks section (org:webhooks).
  • Prepare a receiver URL and decide which event types and Workspaces it should receive.

Create an Endpoint​

  1. Open Webhooks and choose Create.
  2. Enter an endpoint name and destination URL.
  3. Select one or more event types.
  4. Leave Workspace limiting off to cover the Organization, or turn it on and select at least one Workspace.
  5. Choose Create. Copy the signing secret shown after creation and store it securely; the interface presents it once.

The endpoint card shows its status, destination host, subscribed events, and Workspace scope. Use its actions to edit, pause or resume, test, or delete the endpoint.

Test a Receiver​

  1. Open the endpoint actions and choose Test.
  2. Select one of the endpoint's subscribed event types. The dialog loads a sample payload; you can edit the JSON body.
  3. Choose Send and review the receiver's response in the dialog.

A test send is immediate and is not retried or added to the endpoint's delivery log. Use Deliveries on the endpoint card to review regular event deliveries.

What You Should See​

The endpoint card shows current status and scope. The test dialog shows the result from your receiver; the Deliveries panel shows recorded deliveries for the endpoint.

See Webhooks v2 for the event catalog and payload details, and Webhooks v1 → v2 for migration differences. Return to Organizations for the other sections.