Skip to main content
DELETE
Delete Webhook Endpoint
Stops an endpoint from receiving further events. Requires write access on the webhooks scope. Deletion is a soft delete, and it only affects event selection going forward: the endpoint is no longer picked for events that occur after the call, but any delivery already queued or in its retry cycle is still attempted against the old URL. Keep the receiver able to accept, or at least acknowledge, those deliveries for as long as retries can run, up to roughly two days. The endpoint stays visible in List Webhook Endpoints with deleted_at set, but Get, Update and a second Delete all return 404. Deletion cannot be undone; to start receiving events again, create a new endpoint, which gets a new secret.

Path Parameters

string
required
The customer’s external ID (starts with cus_)
string
required
The webhook endpoint’s external ID (starts with wh_)

Response

string
The deleted webhook endpoint ID
string
Always returns "webhook_endpoint"
boolean
Always returns true

Errors

Response Example