Delete Webhook Endpoint

DELETE 
/webhooks/endpoints/:endpointId

Removes one webhook endpoint belonging to the authenticated Refersion user. endpointId is always resolved within the user's own webhook configuration, so another user's id returns the same 404 as an unknown one.

Deleting the same endpoint twice returns 404 on the second call (not idempotent-204 by design), and this operation never auto-provisions a configuration — a user with none simply gets 404.

Rate limit: 30 requests per minute per account, shared across all webhook endpoints. Exceeding it returns 429 with a Retry-After header.

Request

Responses

204

Webhook endpoint deleted

401

Authentication required

402

Billing plan does not include webhook access (merchant principals only)

403

Token type is neither merchant nor marketplace

404

No such endpoint in the caller's own webhook configuration — also the response for another owner's endpoint id, for an already-deleted one, and for a slash-free id of a disallowed shape. An id containing a literal or percent-encoded / matches no route at all and yields 405

405

An endpoint id containing a literal or percent-encoded / matches no DELETE route

429

Rate limit exceeded (30 requests per minute per owner)

500

Internal server error