Skip to main content

Delete a webhook endpoint

POST 

/api/v1/webhooks/delete-endpoint

Deletes the endpoint and its associated provider subscriptions. Already dispatched deliveries can still reach the receiver; deletion does not attest to erasure of historical deliveries or backups.

The following access conditions are preserved as declared intent and are not implemented by generated code: Tenant request context, Tenant-scoped webhook ownership.

Use this in a guide: Receive a completed order summary in your backend

Request​

Responses​

Endpoint deleted successfully

Use an existing endpointId when retiring a receiver.​

Section ID: DOC-IN-webhooks-api-deleteWebhookEndpoint#example-webhooks-deleteWebhookEndpoint-request

Request example

{
"endpointId": "ep_abc123"
}

Illustrative response shape; omitted default fields and actual outcomes depend on the operation.​

Section ID: DOC-IN-webhooks-api-deleteWebhookEndpoint#example-webhooks-deleteWebhookEndpoint-response

Response example

{}

Document ID: DOC-IN-webhooks-api-deleteWebhookEndpoint. Section identities and revisions.

SectionStable reference
Delete a webhook endpointDOC-IN-webhooks-api-deleteWebhookEndpoint#overview
RequestDOC-IN-webhooks-api-deleteWebhookEndpoint#request
ResponsesDOC-IN-webhooks-api-deleteWebhookEndpoint#responses