Skip to main content
PATCH
Updates the delivery URL, the subscribed event filter, or the description of an existing endpoint. All fields are optional; only the fields provided are changed.
The signing secret cannot be changed or re-read via this endpoint.

​
Path Parameters

​
string
required
Id of the owning customer (cus_…).
​
string
required
Id of the webhook endpoint (wh_…).

​
Request Body

​
string (HttpUrl)
New delivery URL.
​
string[]
Replacement list of subscribed event types, validated against the catalog.
​
string | null
New description. Maximum 255 characters. Pass null to clear it.

​
Response

The updated webhook-endpoint object (secret is null on reads after create).
​
string
Id of the endpoint (wh_…).
​
string
Always webhook_endpoint.
​
string
Delivery URL.
​
string[]
Subscribed event types.
​
string | null
Always null on reads after create.
​
string | null
Free-text label for the endpoint.
​
datetime | null
When the endpoint last received a delivery.
​
datetime | null
When the endpoint was disabled; null while active.
​
datetime
When the endpoint was created.
​
datetime | null
When the endpoint was last updated.
​
string
Actor that created the endpoint.
​
string | null
Actor that last updated the endpoint.