DevelopersWebhooks

Real-Time Event Notifications for Your Logistics Stack

Webhooks let Fleetbase push event data directly to your server the moment something happens — an order is dispatched, a driver updates their location, or a delivery is completed. No polling, no delays, no missed updates.

Fleetbase Developer Console — Webhooks management screen with subscriptions, target URLs, and event filters

20+

Event Types

HTTPS

Secure Delivery

4×

Auto Retry

HMAC

Signature Verification

●How It Works

Event-Driven Integration in Three Steps

Fleetbase webhooks follow a simple publish-subscribe model. You tell Fleetbase where to send events, and it handles the rest — delivery, retries, and logging included.

Add your HTTPS URL in Developers → Webhooks and choose which events to subscribe to.

Fleetbase fires the event

When a matching event occurs, Fleetbase immediately POSTs a signed JSON payload to your endpoint.

Your server processes it

Verify the signature, acknowledge with a 200 OK, and process the payload asynchronously in your own system.

Webhook Payload — order.dispatched

POST https://your-server.com/webhooks/fleetbase

X-Fleetbase-Signature: sha256=abc123...

{

"event": "order.dispatched",

"api_version": "1.0",

"created_at": "2026-04-15T09:41:00Z",

"data": {

"id": "order_xxxxxxxx",

"public_id": "ORDER-12345",

"status": "dispatched",

"driver_assigned": {

"name": "James Okafor",

"id": "driver_xxxxxxxx"

"payload": {

"pickup": "12 Marina Bay, Singapore",

"dropoff": "88 Orchard Road, Singapore"

}

All Available Webhook Events

Subscribe to individual events or all events at once. Every event follows the same resource.action naming convention.

Orders

order.createdA new order has been placed in the system.

order.dispatchedAn order has been assigned to a driver and dispatched.

order.startedThe driver has started the order journey.

order.completedThe order has been successfully delivered.

order.cancelledAn order has been cancelled.

order.updatedAny field on an order has changed.

Drivers

driver.assignedA driver has been assigned to an order or fleet.

driver.location_changedThe driver's GPS coordinates have updated.

driver.onlineA driver has gone online and is available.

driver.offlineA driver has gone offline.

driver.updatedA driver's profile or status has changed.

Tracking

tracking_status.createdA new tracking status update has been recorded.

tracking_number.createdA tracking number has been generated for a shipment.

proof_of_delivery.createdA proof of delivery (signature/photo) has been captured.

Fleet & Vehicles

vehicle.updatedA vehicle's details or status have changed.

vehicle.assignedA vehicle has been assigned to a driver or fleet.

issue.createdA new issue or incident has been reported.

issue.updatedAn existing issue has been updated.

issue.resolvedAn issue has been marked as resolved.

What Teams Build with Webhooks

Webhooks are the glue between Fleetbase and the rest of your logistics technology stack.

📱

Customer Order Notifications

Trigger SMS, push, or email notifications the moment an order is dispatched, out for delivery, or completed — without polling.

order.dispatchedtracking_status.createdorder.completed

🗺️

Live Tracking Map

Stream driver GPS coordinates to your own customer-facing tracking page or embedded map widget in real time.

driver.location_changedorder.started

🏢

ERP & WMS Sync

Keep your ERP, WMS, or inventory system in sync with Fleetbase order status changes automatically.

order.createdorder.updatedorder.completedorder.cancelled

📄

Proof of Delivery Archiving

Automatically archive signatures and delivery photos into your document management system or S3 bucket.

proof_of_delivery.created

💰

Billing & Invoicing Triggers

Fire your billing system to generate and send an invoice the moment a delivery is confirmed complete.

order.completedproof_of_delivery.created

🔧

Fleet Maintenance Alerts

Route vehicle issues and driver incidents to your maintenance team or ticketing system instantly.

issue.createdvehicle.updated

●Security

Verify Every Delivery with HMAC Signatures

Every webhook request Fleetbase sends includes an X-Fleetbase-Signature header — an HMAC-SHA256 signature of the raw request body, signed with your webhook secret. Always verify this before processing the payload.

✓

HMAC-SHA256 signature on every request

✓

HTTPS-only delivery — no plain HTTP endpoints

✓

Per-webhook secrets, rotatable at any time

✓

Timing-safe comparison to prevent timing attacks

✓

Full delivery log for audit and debugging

Signature Verification — Node.js

const crypto = require('crypto');

app.post('/webhooks/fleetbase', (req, res) => {

const sig = req.headers['x-fleetbase-signature'];

const expected = crypto

.createHmac('sha256', process.env.WEBHOOK_SECRET)

.update(req.rawBody)

.digest('hex');

if (!crypto.timingSafeEqual(

Buffer.from(sig),

Buffer.from(expected)

)) {

return res.status(401).send('Invalid signature');

}

// Process payload safely

const { event, data } = req.body;

res.sendStatus(200);

});

Reliable Delivery with Automatic Retries

If your endpoint is temporarily unavailable, Fleetbase automatically retries delivery with exponential back-off. Every attempt is logged so you can inspect and replay failed events.

5 minutes

1st retry

30 minutes

2nd retry

2 hours

3rd retry

8 hours

4th retry

After four failed attempts the event is marked as failed and preserved in the delivery log for manual inspection.

Frequently Asked Questions

Start Receiving Webhook Events Today

Set up your first webhook endpoint in under two minutes from the Fleetbase Developer Console.