Webhooks let your system receive automatic notifications whenever an order changes status in swftbox — no need to poll our API repeatedly. This is ideal for keeping your own dashboard, store, or internal tools in sync with delivery progress.
How to set up webhooks
Log in to your Control Room at controlroom.swftbox.com.
Go to Settings → Integrations.
Find the Webhooks section.
Enter your webhook URL — this is the endpoint on your server that will receive the notifications.
Select which events you want to be notified about.
Click Save.
Available webhook events
You can subscribe to notifications for any of these order status changes:
Order Created — A new order has been placed.
Order Confirmed — The order has been confirmed and scheduled for pickup.
Picked Up — The driver has collected the package.
At Depot — The package has arrived at the swftbox sorting facility.
Out for Delivery — The driver is on the way to the customer.
Delivered — The order has been successfully delivered.
Failed — The delivery attempt was unsuccessful.
Returned / RTO — The order is being returned to origin.
Flagged — The order has been flagged for an issue (bad address, customer refusal, etc.).
What the webhook payload looks like
Each webhook sends a JSON payload to your URL containing:
Order ID and reference number
New status and timestamp
Customer details (name, phone, address)
Tracking URL
Driver details (when applicable)
Delivery proof (when delivered)
Technical requirements
Your webhook endpoint must accept POST requests.
The endpoint must return a 200 OK response to confirm receipt.
Use HTTPS for your webhook URL (required for security).
If your endpoint is unreachable or returns an error, swftbox will retry the webhook delivery.
Testing your webhook
Before going live, we recommend using a webhook testing service (such as webhook.site) to inspect the payloads swftbox sends. This helps you verify your endpoint is receiving data correctly before connecting it to your production system.
Good to know
Webhooks complement the tracking updates that already flow to Shopify and WooCommerce integrations.
If you use the Direct API, webhooks are the recommended way to track order status (instead of polling the status endpoint).
You can update or disable webhooks at any time from Settings → Integrations.
Need help with webhook setup? Reach out to us via the chat icon or WhatsApp.