Event & Webhook APIs
Skeep uses webhooks to notify your system about delivery updates in real-time. This is the recommended way to keep your database in sync.
Webhook Registration
1. Register Webhook
POST /webhooks
Register a URL to receive POST requests for specific event types.
2. List Webhooks
GET /webhooks
View all active webhook registrations.
Event Types
| Event | Description |
|---|---|
delivery.created | New delivery order accepted. |
courier.assigned | A rider has accepted the job. |
picked_up | Courier has collected the package. |
in_transit | Courier is moving toward destination. |
delivered | Package successfully dropped off. |
canceled | Order has been terminated. |
Webhook Security
All webhook requests include a X-Skeep-Signature header. Validation documentation is available in the Authentication section.