Update a webhook subscription
Updates a webhook subscription — pause/resume it, change the URL or custom headers, or rotate the signing secret. When you request rotation the new secret is returned once in this response.
Headers
Client-generated unique key per operation intent (UUID). Same key + identical body replays the original response; same key + different body returns 409.
Path Parameters
Body
2551000HTTPS endpoint that deliveries are POSTed to.
Set PAUSED to pause deliveries or ACTIVE to resume them.
ACTIVE, PAUSED Replaces the stored custom headers. Values are write-only and never returned.
Set true to rotate the signing secret. The new secret is returned once in the response.
Response
Platform-assigned stable identifier.
Human-readable name for the subscription.
HTTPS endpoint deliveries are POSTed to.
The event type this subscription receives.
ACTIVE, PAUSED, FAILED Names of configured custom headers. Header values are never returned.
Consecutive delivery failures since the last success.
Pinned payload API version.
The new signing secret — present only when secret rotation was requested. Shown once.