ShipBob Logistics Webhook

The Tracking Received webhook is designed for 3PL merchants who want real-time updates when ShipBob receives tracking details for ShipBob Logistics orders.

This guide outlines the steps to set up the order.shipment.tracking_received webhook.

1. Subscribe to the tracking received webhook

To receive tracking updates, merchants must subscribe to the order.shipment.tracking_received webhook using the ShipBob Public Webhooks API.

Refer Shipbob Developer API for creating webhook subscription from here.

Request Payload:

1
{ 
2
  "topics": ["order.shipment.tracking_received"], 
3
  "url": "https://mywebsite.com/shipbob/handler"
4
}

2. Handling Webhook Notifications

Once subscribed, your webhook handler will receive real-time tracking updates from ShipBob in the following payload format.

Webhook Payload Example:

1
{
2
  "event_time": "2025-10-23T15:55:09.3614767Z",
3
  "order_id": 100000001,
4
  "reference_id": "TEST101",
5
  "status": "LabelCreated",
6
  "tracking": {
7
    "carrier": "USPS",
8
    "carrier_service": "ParcelSelect",
9
    "tracking_id": "9261290306529427911297",
10
    "tracking_url": "https://tools.usps.com/go/TrackConfirmAction!input.action?tRef=qt&tLc=0&tLabels=9261290306529427911297"
11
  }
12
}

To understand more about Shipbob webhooks and how do they work, please refer to our webhooks documentation.

3. Implementing the Webhook Handler

Steps to Implement the Webhook Handler:

1. Set up an endpoint on your server (e.g., https://mywebsite.com/shipbob/handler).
2. Validate incoming requests to ensure they originate from ShipBob.
3. Parse the payload and extract relevant tracking details.
4. Store or process tracking updates as needed (e.g., update order status in your system).
5. Respond with HTTP 200 OK to acknowledge receipt of the webhook.

FAQs