Webhooks Overview
Receive real-time event updates when actions occur on Rehabify.
Webhooks Overview
Webhooks allow Rehabify to notify your server in real time whenever an event occurs (such as a patient finishing their WhatsApp intake, a therapist confirming an appointment, or a patient completing a session).
Code
sequenceDiagram
participant Patient as Patient (WhatsApp)
participant Rehabify as Rehabify Engine
participant Partner as Your Server
Patient->>Rehabify: Completes Intake & Selects Time
Rehabify->>Rehabify: Matches MRTBN Physio
Rehabify->>Partner: POST /webhook (event: patient.intake_completed)
Partner-->>Rehabify: 200 OKHow Webhooks Work
- You configure a webhook endpoint URL in your Partner Portal settings (e.g.
https://api.yourdomain.com/webhooks/rehabify). - When an event occurs in Rehabify, we construct an event object and send an HTTP
POSTrequest with a JSON payload to your configured URL. - Your server validates the
X-Rehabify-Signatureheader to ensure authenticity and responds with an HTTP200 OKstatus.
Headers Included with Every Webhook
| Header | Description |
|---|---|
Content-Type | application/json |
X-Rehabify-Event | The type of event (e.g. session.completed) |
X-Rehabify-Delivery-Id | Unique ID for this webhook delivery attempt |
X-Rehabify-Signature | HMAC SHA-256 signature generated using your webhook secret |
X-Rehabify-Timestamp | Unix timestamp of when the webhook was generated |
Next Steps
- Explore the full Event Catalog to see all available event payloads.
- Implement Signature Verification to securely validate payloads.
- Learn about our Retry Policy and delivery guarantees.