Update a webhook subscription.
PUT/webhooks/:id
Updates the fields provided and leaves the rest unchanged. Passing event_types replaces the subscribed set rather than adding to it; omitting it leaves the current set alone.
Set enabled to false to pause delivery, and true to resume it. Resuming also clears the accumulated failure count, so a subscription disabled automatically after sustained failures starts fresh once the endpoint is healthy again.
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 409
- 422
- 429
The updated subscription.
An unknown event type was provided.
API key authorization failed.
The API key is read-only and may not be used to update a webhook.
No such webhook subscription for this user.
A concurrent webhook request for this user is already in progress. Retry once it completes.
The endpoint was rejected. It must be an https URL on port 443 that
resolves to a publicly routable address. This is re-checked before every
delivery, so an endpoint that stops meeting it also stops receiving events.
Rate limit exceeded — the API key has sent too many requests. Wait before retrying. See the Rate Limits section in the overview for the recommended exponential backoff strategy.