Webhooks
Create a webhook endpoint
Registers an HTTPS URL for one or more events. Returns the signing secret.
AuthorizationBearer <token>
API key as Bearer token: Authorization: Bearer luc_live_.... Create keys in the dashboard under Settings > API Keys.
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
curl -X POST "https://example.com/v1/webhook-endpoints" \ -H "Content-Type: application/json" \ -d '{ "url": "https://example.com/lucius/webhooks", "events": [ "customer.created", "contract.created" ], "description": "Production listener" }'{ "object": "webhook_endpoint", "id": "8b1f6c2e-4a1d-4e0b-9a51-3f0e2c7d9a10", "url": "https://example.com/lucius/webhooks", "description": "Production listener", "events": [ "customer.created", "contract.created" ], "status": "enabled", "created_at": "2026-10-02T10:00:00.000Z", "secret": "whsec_3f9c0d1e2a4b5c6d7e8f90a1b2c3d4e5f60718293a4b5c6d"}{ "error": "URL must use https"}{ "error": "Missing API key"}