{
"occurred_at": "2026-09-16T10:00:02Z",
"team_uuid": "11111111-1111-4111-8111-111111111111",
"id": "896b145e-01e2-5839-9bb2-653ccddfe9de",
"type": "shipment.booked",
"data": {
"shipment_uuid": "22222222-2222-4222-8222-222222222222",
"batch_uuid": "55555555-5555-4555-8555-555555555555"
}
}Webhooks
Receive team resource updates
Verify Standard Webhooks headers against the raw request body before processing: HMAC-SHA256 over webhook-id + "." + webhook-timestamp + "." + raw body, using the decoded whsec_ signing secret; webhook-signature carries v1,<base64 signature>. Use a 5-minute timestamp tolerance and deduplicate by id. The delivery timestamp changes on retry; event id and occurred_at do not. Acknowledge with any 2xx within 10 seconds after durably accepting the event. Non-2xx or timeout triggers retries with backoff for up to 24 hours. Delivery order is not guaranteed and duplicate delivery is possible. Payloads are thin resource notifications. The event id, body and occurred_at are fixed when the event is created and remain unchanged across delivery attempts. The signed webhook-timestamp header changes for each attempt. Fetch current data through the API when needed; later state can supersede the event. Resume the tracking feed for tracking notifications and apply shipment.deleted using its identifier without a GET. Callback failure never changes booking results or repeats side effects.
WEBHOOK
teamEvents
{
"occurred_at": "2026-09-16T10:00:02Z",
"team_uuid": "11111111-1111-4111-8111-111111111111",
"id": "896b145e-01e2-5839-9bb2-653ccddfe9de",
"type": "shipment.booked",
"data": {
"shipment_uuid": "22222222-2222-4222-8222-222222222222",
"batch_uuid": "55555555-5555-4555-8555-555555555555"
}
}Headers
Stable event identifier, matching body.id.
Unix seconds for this delivery attempt.
Pattern:
^[0-9]+$Space-delimited Standard Webhooks signatures, each v1,.
Body
application/json
- Option 1
- Option 2
- Option 3
- Option 4
- Option 5
Thin event envelope: stable id, event type, occurred_at, team_uuid and resource identifiers in data. Full payloads are not offered in this version. A future full-payload option must be explicitly selected; existing thin subscriptions retain their documented meaning.
Stable event UUID, also sent in webhook-id. Duplicate deliveries keep the same id.
When the business event occurred; distinct from the delivery-attempt timestamp.
Resource UUID.
Available options:
shipment.booked, shipment.failed, shipment.cancelled, shipment.voided Show child attributes
Show child attributes
Response
Event durably accepted. Other 2xx responses also acknowledge delivery.
Was this page helpful?