Webhooks

Webhooks let you receive real-time notifications when events occur in your clinic — without polling the API.

How It Works

1. Register a webhook endpoint URL in the dashboard or via API
2. WioClinic sends an HTTP POST to your URL whenever a subscribed event fires
3. Your endpoint acknowledges with 2xx — otherwise we retry with exponential backoff

Delivery Guarantees

• At-least-once delivery — your endpoint may receive duplicate events
• Retries — up to 5 attempts over ~1 hour on non-2xx responses
• Ordering — not guaranteed; use event.created_at for sequencing

Payload Structure

{
  "id": "evt_018g1h2i-…",
  "event": "appointment.created",
  "clinic_id": "018a…",
  "created_at": "2026-02-15T09:00:00+03:00",
  "data": { ... }
}

See Signature Verification to authenticate incoming requests.