Rotate or disable the webhook
Generate a new URL and secret if the secret was lost or exposed, or disable the webhook to stop receiving events.
On this page
Rotating the webhook replaces its URL and secret with new ones: the previous ones stop working instantly. Disabling it makes the URL stop accepting events, without deleting the integration or its events.
Before you start
You need the Administrator role. With another role, these buttons don't appear on the card.
Coordinate with whoever manages the external system: after rotating, they'll have to configure it with the new details.
Rotate the webhook
Do it if you lost the secret, if you think someone else knows it, or as part of your periodic key rotation.
Go to Settings → Integrations.
On the integration's card, press Rotate.
Confirm in Rotate the webhook for "…"? with Yes, rotate. The notice reminds you that the external system won't be able to send events until you configure it with the new details.
Webhook enabled opens with the new URL and secret. Copy them and configure your system, as in Enable the webhook and send events.
Press I've copied it, close and, in Have you copied the secret?, confirm with Yes, close.
Between the rotation and the reconfiguration of the external system, its events are rejected and not recorded. Have the change ready in the other system before rotating.
Disable the webhook
Do it when you stop using the system or want to cut off event submissions immediately.
On the integration's card, press the Disable webhook button (next to Rotate).
Confirm in Disable the webhook for "…"? with Yes, deactivate. The notice reminds you that you can enable it again later, with a new secret.
You'll see Webhook disabled. and the card's Webhook field will say Disabled.
Enable it again
Press Webhook on the card. A new URL and secret are generated immediately and Webhook enabled opens: the previous URL and secret can't be recovered.
If you only want to stop receiving events for a while and keep the same URL and secret, edit the integration and change its Status to Paused. See Edit, pause or delete an integration.
What happens next
Events that already arrived are kept in Received events. While the webhook is disabled, submissions from the external system are rejected.