Skip to main content

Create Webhook

POST /webhooks

Registers a new webhook endpoint.

Scope required: webhook.write

Request Body

{
"url": "https://yourapp.com/webhooks/wioclinic",
"events": ["appointment.created", "appointment.cancelled"],
"secret": "your-signing-secret"
}
FieldTypeRequiredDescription
urlstringHTTPS URL that will receive events
eventsarrayEvent types to subscribe to
secretstringUsed to sign payloads for verification

Response 201

{
"data": {
"id": "018g1h2i-…",
"url": "https://yourapp.com/webhooks/wioclinic",
"events": ["appointment.created", "appointment.cancelled"],
"is_active": true
}
}