Updating a Webhook

Modify a webhook's target URL, delivery mode, or event filter, and pause or re-enable it with the status endpoint.

Certain fields of a webhook can be modified after creation:

PUT https://api.getguru.com/api/v1/webhooks/{webhookId}

Modifiable fields

All fields are required when updating a webhook. The request and response match the examples in Creating a Webhook.

Changing the status of a webhook

The owner of a webhook can switch it between ENABLED and DISABLED at any time. If a webhook is having problems, pause it (DISABLED) while you resolve them, then re-enable it (ENABLED):

PUT https://api.getguru.com/api/v1/webhooks/{webhookId}/status?value={status}

❗️

Events are lost while a webhook is disabled

While a webhook is not ENABLED, any events generated during that time are lost. They are not queued for later delivery.

Certain errors may also cause the system to automatically mark the webhook as ERRORED, and the owner is notified by email. The reason appears in the webhook's statusReason field; see Creating a Webhook for how to retrieve a webhook.