Webhooks

Subscribe to real-time event notifications.

GET/v1/webhooks

List configured webhook endpoints.

{ "data": [{ "id": "wh_601", "url": "https://example.com/hook", "events": ["payment.succeeded"], "active": true }] }

POST/v1/webhooks

Create a webhook endpoint.

Name	Type	Required	Description
url	string	required	HTTPS endpoint URL
events	string[]	required	Events to subscribe to

{ "url": "https://example.com/hook", "events": ["payment.succeeded", "user.created"] }

{ "id": "wh_602", "url": "https://example.com/hook", "secret": "whsec_abc123...", "active": true }

PUT/v1/webhooks/:id

Update a webhook endpoint.

{ "events": ["payment.succeeded", "payment.failed"] }

{ "id": "wh_601", "events": ["payment.succeeded", "payment.failed"], "active": true }

DELETE/v1/webhooks/:id

Delete a webhook endpoint.

{ "success": true }