flexport-webhooks-events

# Flexport Webhooks & Events ## Overview Flexport sends webhook notifications for shipment milestones, booking confirmations, PO updates, invoice events, and document availability. Webhooks are configured in Portal > Settings with a secret token for HMAC-SHA256 signature verification via the `X-Hub-Signature` header. ## Webhook Event Types | Category | Events | Use Case | |----------|--------|----------| | Milestones | `cargo_ready`, `departed`, `arrived`, `customs_cleared`, `delivered` | Shipment tracking | | Transit | `estimated_departure`, `estimated_arrival`, `actual_departure` | ETA updates | | Bookings | `booking_confirmed`, `booking_amended` | Booking lifecycle | | Purchase Orders | `po_created`, `po_updated`, `po_archived` | PO management | | Invoices | `invoice_created`, `freight_invoice_ready` | Billing | | Documents | `document_uploaded`, `bill_of_lading_ready` | Document management | | Container | `container_loaded`, `container_unloaded` | Container tracking | ## Instructions ### Step 1: Create Webhook Endpoint in Flexport Navigate to Portal > Settings > Webhooks > Add Endpoint: - URL: `https://your-app.com/webhooks/flexport` - Secret: Generate a strong random string - Events: Select event types to subscribe to ### Step 2: Implement Webhook Handler ```typescript import crypto from 'crypto'; import express from 'express'; const app = express(); // IMPORTANT: Use raw body for signature verification app.post('/webhooks/flexport', express.raw({ type: '*/*' ...