Create Webhook Endpoint
POST/webhooks/endpoints
Registers a webhook endpoint for the authenticated Refersion user —
lets an account subscribe programmatically instead of only through the
webhook settings portal. Some users can only subscribe to a limited set
of event types — anything else returns 422. Some users may receive a
402 if their plan doesn't include webhook access. The user's webhook
configuration is auto-provisioned on first call. The 201 response's id
is also what DELETE /v3/webhooks/endpoints/{endpointId} accepts.
Request
Responses
- 200
- 201
- 401
- 402
- 403
- 422
- 429
- 500
Webhook endpoint created successfully
Authentication required
Billing plan does not include webhook access (merchant principals only)
Token type is neither merchant nor marketplace
Invalid URL, empty topics, 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