Receive Tracking Webhook
POST/webhooks/pinnacle/:webhook_token
The endpoint Metropolitan Warehouse & Delivery (MWD) calls to push tracking updates — you configure it with MWD, you do not call it yourself. Get the full URL and key from Get Webhook Endpoint.
Authentication: no Bearer token. MWD must send the instance's inbound key in the authorization header (a "Bearer " prefix is tolerated). A missing or wrong key returns 401; an unknown webhook token returns 404.
Body: a Pinnacle GetTrackingDetails snapshot for one delivery — orderInfo (trackingNumber required), orderItems, trackingInfo, eventHistory and notes. A JSON array of snapshots, or the enveloped {status, message, result} API response, is also accepted. The raw body is stored and processed in the background; an identical repeat of a snapshot already processed is acknowledged with duplicate=true and not re-applied. An empty body returns 400; a body that is not a JSON tracking snapshot or carries no tracking number returns 422.
Request
Responses
- 200
- 400
- 401
- 404
- 422
- 429
OK
Response Headers
Bad Request
Response Headers
Unauthorized
Response Headers
Not Found
Response Headers
Unprocessable Entity
Response Headers
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.