Subscribe to shipment tracking via the project44 visibility API

Steps

1. Authenticate against the project44 OAuth 2.0 token endpoint using your client credentials to obtain a bearer token; regional base URLs differ (e.g., na12.api.project44.com for North America, eu12.api.project44.com for Europe).
2. Register your webhook callback URL by POST-ing to /api/v4/webhooks with your endpoint URL and the event types you wish to receive; store the returned webhook configuration ID.
3. Create or import a shipment via the appropriate mode-specific endpoint (Parcel, LTL, Truckload, Ocean) supplying carrier SCAC or carrier ID, PRO/tracking number, and origin/destination data.
4. project44 begins pushing status updates to your registered webhook as events occur; each push uses the same payload format as GET /api/v4/shipments/{shipmentId}/tracking/history.
5. Note the tenant limit of 50 push configurations — if you need more, either use broad filter criteria per webhook or contact project44 to discuss limit increases.
6. For parcel mode, use the dedicated parcel webhook endpoint at /api/v4/parcel/webhook/endpoint for registration, which has a slightly different configuration schema than the general webhook endpoint.