WEBHOOKS
Webhooks
Receive secure, reliable real-time notifications when important Mediloop events occur.
Real-time
Event driven
As events happen
Reliable delivery
Automatic retries
Exponential backoff
Signatures
HMAC SHA-256
Verify every payload
Endpoint limit
100 endpoints
Per tenant
Payload
JSON
Versioned envelope
About webhooks
Webhooks deliver asynchronous platform events to HTTPS endpoints you control. They complement, rather than replace, synchronous APIs.
How it works
1
Subscribe
Register endpoint + events
2
Event occurs
Mediloop creates event
3
Signed delivery
HTTPS POST is sent
4
Acknowledge
Return 2xx quickly
Key features
| Feature | Behavior |
|---|---|
| Reliable delivery | Automatic retries with exponential backoff |
| Event filtering | Subscribe only to selected event families |
| Signature verification | HMAC SHA-256 payload signatures |
| Delivery history | Inspect attempts and response metadata |
| Secret rotation | Rotate endpoint secrets safely |
Event lifecycle
| State | Meaning |
|---|---|
| created | Event recorded |
| pending | Awaiting delivery |
| delivered | Endpoint returned success |
| retrying | Scheduled for another attempt |
| failed | Retry policy exhausted |
Create an endpoint
Create webhook endpoint
curl -X POST "https://api.mediloop.com/v1/webhooks" \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"url":"https://webhooks.example.com/mediloop","events":["prescription.signed","delivery.completed"]}'Example response
201 Created{"data":{"id":"wh_123","active":true,"secret":"whsec_••••••"}}