Update Webhook Endpoint
PATCH/webhooks/endpoints/:endpointId
Updates the delivery URL, subscribed event types, or both, for 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.
Omitted fields are left unchanged; topics REPLACES the subscription
rather than merging into it. Some users can only use a limited set of
event types — anything else returns 422. Some users may receive a 402
if their plan doesn't include webhook access. Like delete, this never
auto-provisions a configuration — a user with none gets 404.
Request
Responses
- 200
- 401
- 402
- 403
- 404
- 405
- 422
- 429
- 500
Webhook endpoint updated successfully
Authentication required
Billing plan does not include webhook access (merchant principals only)
Token type is neither merchant nor marketplace
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
An endpoint id containing a literal or percent-encoded / matches no PATCH route
Neither url nor topics supplied, an invalid URL, empty topics, an unknown event type, or a marketplace member requesting a merchant-only event type
Rate limit exceeded (30 requests per minute per owner)
Internal server error