3PL Webhook Integration Guide

Why 3PL Webhooks Matter for Ecommerce

Third-party logistics providers (Shippo, EasyPost, ShipBob) manage fulfillment after you hand off an order. Webhooks keep your system in sync: when the 3PL picks and ships, you need to know immediately to update order status, notify customers, and trigger downstream workflows (email campaigns, inventory adjustments, return flows).

Without webhooks, you'd poll the 3PL API constantly. With webhooks, events arrive in real-time (or with a 24-48h SLA for some providers). This enables:

• Real-time tracking number sync to order confirmation emails
• Automated return label generation when a shipment is returned
• Inventory deallocation once the 3PL confirms pick
• Customer notifications ("Your order shipped!" → "Out for delivery" → "Delivered")
• Chargeback prevention by confirming delivery timestamps

Key 3PL Webhook Events

Testing 3PL Webhooks with Requex.me

Before deploying, test webhook payloads locally with a free endpoint:

1. Visit Requex.me and copy your unique webhook URL.
2. In your 3PL dashboard, register the webhook endpoint. Example: https://your-id.requex.me
3. In your 3PL admin, create a test shipment or label.
4. Watch the webhook payload appear instantly in your Requex dashboard.
5. Inspect the payload, signature header, and event type. Verify your webhook handler can parse it.

Requex captures and displays the raw HTTP request including headers and body—useful for debugging signature verification before deploying to production.

Four Common 3PL Webhook Challenges

3PL Webhook Signature Verification

All major 3PLs sign their webhooks using HMAC-SHA256. Verify the signature before processing:

// Node.js / Express middleware for 3PL signature verification
const crypto = require('crypto');

function verify3PLSignature(req, signatureHeader, secret, algorithm = 'sha256') {
    const hash = crypto
        .createHmac(algorithm, secret)
        .update(req.rawBody) // Raw body BEFORE JSON parsing
        .digest('hex');

    return crypto.timingSafeEqual(
        Buffer.from(signatureHeader),
        Buffer.from(hash)
    );
}

// Shippo example
app.post('/webhooks/shippo', express.raw({type: 'application/json'}), (req, res) => {
    const signature = req.headers['x-shippo-signature'];

    if (!verify3PLSignature(req, signature, process.env.SHIPPO_WEBHOOK_SECRET)) {
        return res.status(401).json({ error: 'Invalid signature' });
    }

    const payload = JSON.parse(req.body);
    const webhookId = payload.id;

    // Check idempotency: have we processed this webhook_id?
    const existing = await Webhook.findOne({ webhookId });
    if (existing) return res.status(200).json({ received: true });

    // Save webhook for idempotency
    await Webhook.create({ webhookId, event: payload.event, payload });

    // Process shipment update
    if (payload.event === 'track_updated') {
        const { tracking_status } = payload.data;
        await Order.update({ orderId: payload.data.order_id }, { trackingStatus: tracking_status });
    }

    res.status(200).json({ received: true });
});

Data Flow: Order → 3PL → Webhook → Your Fulfillment Status

Here's how a typical order flows through a 3PL integration:

1. Order placed: Customer buys on your storefront. Order created with items and shipping address.
2. Send to 3PL: Your backend calls POST /shipments to Shippo/EasyPost with order details. 3PL responds with shipment_id.
3. 3PL picks & packs: Warehouse receives the order, picks items, packs box. Status progresses: pending → label_generated → picked → packed.
4. Label created webhook: 3PL sends webhook label.created with tracking number.
5. Your webhook handler: Receives webhook, verifies signature, stores tracking number, updates order status to "shipped".
6. Customer notified: Your email system triggers "order shipped" email with tracking link.
7. Tracking updates: As package moves, carrier sends events to 3PL. 3PL forwards track_updated webhooks.
8. Final delivery: track_updated event with status "delivered" triggers final customer notification and closes fulfillment loop.

See Also

For broader integration patterns, see Shopify API integrations and Shopify alternatives for developers.