Skip to main content

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

EventDescription
delivery.createdNew delivery order accepted.
courier.assignedA rider has accepted the job.
picked_upCourier has collected the package.
in_transitCourier is moving toward destination.
deliveredPackage successfully dropped off.
canceledOrder has been terminated.

Webhook Security

All webhook requests include a X-Skeep-Signature header. Validation documentation is available in the Authentication section.