.svg?fit=max&auto=format&n=vy0mukkT7J4oGoAc&q=85&s=309fd13aafaa2459ab88bae66ee69fdb)
.svg?fit=max&auto=format&n=vy0mukkT7J4oGoAc&q=85&s=d463f8e401c13f13ee15256db8c610dd)
Platform API reference
Update Webhook Endpoint
Change a webhook endpoint’s URL, event types, or status. Setting status to ACTIVE re-enables an auto-disabled endpoint and resets its failure counter.
PATCH
Updates a webhook endpoint. All body fields are optional — send only what you want to change. Setting
status to ACTIVE re-enables an auto-disabled endpoint and resets its failure counter.
Updating never changes the signing secret, and the secret is never returned. To rotate it, delete the endpoint and create a new one.
Requirements: webhooks:manage scope.
Request
string
required
The webhook endpoint ID.
string
New delivery URL. Must be HTTPS (
http is allowed for localhost only).string[]
Replacement list of event types — at least one.
string
ACTIVE or DISABLED. ACTIVE re-enables an auto-disabled endpoint and resets consecutiveFailures to 0; DISABLED pauses delivery.Response
object
The updated endpoint:
{id, url, eventTypes, status, createdAt, consecutiveFailures, disabledAt, disabledReason} — same shape as GET /webhook-endpoints/{endpointId}.