{
"id": "896b145e-01e2-5839-9bb2-653ccddfe9de",
"team_uuid": "11111111-1111-4111-8111-111111111111",
"occurred_at": "2026-09-16T10:00:02Z",
"type": "shipment.booked",
"data": {
"shipment_uuid": "22222222-2222-4222-8222-222222222222",
"batch_uuid": "55555555-5555-4555-8555-555555555555"
}
}Receive team resource updates
Receives signed notifications about changes to team resources.
{
"id": "896b145e-01e2-5839-9bb2-653ccddfe9de",
"team_uuid": "11111111-1111-4111-8111-111111111111",
"occurred_at": "2026-09-16T10:00:02Z",
"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. Deduplicate by this identifier; the event body and occurred_at remain unchanged across retries. Delivery may be duplicated or arrive out of order.
Unix seconds for this delivery attempt. Verify with a 5-minute tolerance; the timestamp changes on each retry.
^[0-9]+$Space-delimited Standard Webhooks signatures, each v1,<base64 signature>. Before processing, verify HMAC-SHA256 over webhook-id + "." + webhook-timestamp + "." + the raw request body using the base64-decoded whsec_ signing secret.
Body
- 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.
Resource UUID.
When the business event occurred; distinct from the delivery-attempt timestamp.
shipment.booked, shipment.failed, shipment.cancelled, shipment.voided Show child attributes
Show child attributes
Response
Event durably accepted. Acknowledge with any 2xx within 10 seconds; a non-2xx response or timeout triggers retries with backoff for up to 24 hours.
Was this page helpful?