Skip to main content

Delete a webhook

Delete an endpoint when the system it sends to is gone for good, such as a retired chat bridge or a receiver you replaced with a new endpoint. Deleting stops every delivery to its URL at once and removes the endpoint's events, projects, signing secret and delivery log. It can't be undone: to bring it back you create a new endpoint, with a new secret. What an endpoint holds is in How webhooks work.

You need to be an Owner or Admin of your organization, on a plan that includes webhooks.

Not sure it's for good? Pause a webhook instead: it keeps the endpoint and its log. If the receiver only moved, move the webhook to a new URL.

  1. Open Settings, select Integrations, then Webhooks.

  2. Select the endpoint's name. It opens on its Settings tab; check its URL to be sure it's the endpoint you mean.

  3. Select the Deliveries tab. A row still Retrying stops being tried once you delete. If your receiver still needs it, wait for it to show Delivered, or keep the endpoint for now. Copy anything you want to keep from the log: it is deleted with the endpoint.

  4. Select ⋯ beside Send test, then Delete.

  5. The Delete webhook? dialog names the endpoint and says Its delivery log goes too. Nothing more is sent to this URL. Select Delete. If it says Could not delete. Retry., select Delete again.

  6. Jaah returns to Webhooks, and the endpoint is gone from the list. With none left, the page reads No webhooks yet.

    The Webhooks page with no endpoints left: No webhooks yet and New webhook

  7. Retire the receiver's side: remove the endpoint's signing secret from its configuration, and turn the receiver off if nothing else uses it. Jaah sends nothing more to that URL.

The deletion, like every change to an endpoint, is recorded in Audit.