Webhooks allow you to be notified on your server when certain events happen, rather than having to poll our API all the time. For more info on webhooks in general see working with webhooks
When subscribing to a webhook, the following can be configured:
- URL: the URL the webhook notification will be sent to
- HTTP HEADERS: Additional custom headers to be sent as part of the HTTP request (this can be used to perform authentication)
You can configure webhooks through the partner portal under the developer section.
Failed notifications are retried up to a maximum of
The backoff delay is
5000 milliseconds multiplied by the number of retries.
Webhooks are available for the following Objects and Events:
Webhooks fire as a customer order transitions through each order state (dispatched, delivered, etc.)
|Order created||Order has been created||ORDER.CREATED|
|Order dispatched||Order has been dispatched||ORDER.DISPATCHED|
|Order out for delivery||Order is out for delivery (Note: this is subject to shipping method)||ORDER.OUT_FOR_DELIVERY|
|Order delivered||Order delivered to customer (Note: this is subject to shipping method)||ORDER.RECEIVED|
Webhooks fire as a customer phlebotomy order transitions through each state (nurse assigned, appointment scheduled, etc.)
|Nurse assigned||Nurse has been assigned (Mobile Phlebotomy Only)||PHLEBOTOMY.NURSE_ASSIGNED|
|Appointment scheduled||Appointment has been scheduled||PHLEBOTOMY.APPOINTMENT_SCHEDULED|
|Appointment rescheduled||Appointment has been rescheduled||PHLEBOTOMY.APPOINTMENT_RESCHEDULED|
|Appointment cancelled||Appointment has been cancelled||PHLEBOTOMY.APPOINTMENT_CANCELLED|
Webhooks fire as a customer test transitions through the each testing state (registered, received by the lab, resulted, etc.)
|Test registered||Test has been registered by patient||TEST.REGISTERED|
|Test received at lab||Test has been received by the lab||TEST.LAB_ACCESSIONED|
|Test results ready||Lab test results are ready||TEST.PROCESSED|
|Test commentary uploaded||A clinical commentary has been uploaded||TEST.CLINICAL_COMMENTARY_UPLOADED|
Full webhook event schemas
View event schemas for the full details of each webhook.
Check out Security section for more details on how to keep your implementation secure.
Updated 3 months ago