Skip to main content

Delete an endpoint

Availability pending. Check applicability.

Object and complete fields · Authentication, amounts and errors · Integration guide

DELETE /v1/webhook-endpoints/{id}

Deletes an endpoint and stops delivery of new events to it. Recreating an endpoint generates a new ID and signing secret.

Attributes​

AttributeLocationTypeRequiredDescription
Idempotency-KeyheaderstringYesUnique key for this operation; reuse the original value when retrying
idpathstringYesUnique endpoint identifier

There is no request body.

Request example​

DELETE /v1/webhook-endpoints/we_example
Authorization: Bearer inv_test_...
Idempotency-Key: de68649e-3869-4d8c-b267-61e6e0732311

Response example​

200 OK, with the deleted endpoint's ID and deletion result.

{
"id": "we_example",
"deleted": true
}

A valid idempotent retry of the same deletion returns the original successful response.

Business error codes