Register an endpoint
Register an HTTPS URL to receive signed event deliveries. The signing secret is returned once here and never again: store it before you close the connection. An unrecognised event type is dropped silently rather than rejected, so read event_types back from the response. Answers 201 on success, 400 INVALID_URL when the URL is missing or not https.
Not counted: webhook management is an account path and spends no call quota. The event deliveries we send are free. See what counts as a successful request.
Request body
Where we post deliveries. Must start with https://.
Event types to receive. Omit or send [] to receive every event type we emit. Accepted values: container_arrived, container_available, container_delivered, customs_hold, vessel_departed, eta_changed, container_misrouted, demurrage_started, demurrage_warning, schedule_disruption, shipment_updated and api_change_announced.
Your own label. We never interpret it.
Response schema
100 fields
Generated from the OpenAPI spec. Nested exactly as the JSON is. Open a branch to read its fields; hover a name for the full dot-path.
Whether the request succeeded.
data
A registered webhook endpoint.
Stable identifier for the record. On the tracking endpoints this is the container UUID, except on a portfolio summary row, where it is the container number.
Where we POST the events.
The stored subscription, after unrecognised names were filtered out. One of: api_change_announced, container_arrived, container_available, container_delivered, container_misrouted, customs_hold, demurrage_started, demurrage_warning, eta_changed, schedule_disruption, shipment_updated, vessel_departed, vessel_rollover.
The carrier own phrasing for the event, falling back to our word for the code.
False while the endpoint is paused. A paused endpoint keeps its secret and its history.
Consecutive delivery failures.
When the record was created (ISO 8601).
When the endpoint was disabled.
Manual disable or automatic disable after repeated delivery failures.
Last receiver error at automatic disable; null for manual disable or an active endpoint.
Signing secret.
When tracking stopped. Only on status 400, 401, 403, 409, 429, 500 and 504.
Null when your account archived it, otherwise the reason our archiver closed it. Only on status 400, 401, 403, 409, 429, 500 and 504.
resume
Only on status 400, 401, 403, 409, 429, 500 and 504.
body
The reference to add again.
The response contract this build answers, as a date (YYYY-MM-DD).
error
Only on status 400, 401, 403, 409, 429, 500 and 504.
Machine readable error code.
Human readable explanation.
How serious the error is.
True.
The reference.
Seconds to wait.
Offending fields.
CONTAINER_QUOTA_EXCEEDED only.
Tokens this request needs.
Tokens the wallet holds.
Where to top up.
Plans on offer.
packages[]
Plan key.
Tokens per month.
Monthly price in USD.
CARRIER_NOT_IDENTIFIED only.
CARRIER_NOT_IDENTIFIED, timed out only.
The member cycle limit.
Tokens the member has used this cycle.
Tokens left for the member.
Seconds until the next refresh is allowed.
progress
One of: SEALINE_HASNT_PROVIDE_INFO, NO_EVENTS, WRONG_NUMBER, REFERENCE_REQUIRED, LINE_NOT_SUPPORTED, PENDING, UNRESOLVED.
previous_trip
The trip before yours for this box, when the line still reports it.
The line that answered, as its SCAC.
last_event
events[]
A note for leasing-company accounts when no line holds the box yet.
One of: in_progress, not_supported, connected, reference_required.
carrier_notice
Latest reference-specific reply from the named carrier. Only on status 400, 401, 403, 409, 429, 500 and 504.
One of: other_carrier, temporarily_unavailable, not_found, invalid_reference, SHIPMENT_CANCELLED, no_longer_available.
Present when the line named was not used. Only on status 400, 401, 403, 409, 429, 500 and 504.
Known line that cannot be asked. Only on status 400, 401, 403, 409, 429, 500 and 504.
upgrade
CONTAINER_QUOTA_EXCEEDED only. Only on status 400, 401, 403, 409, 429, 500 and 504.
Next plan.
Monthly price.
Annual price.
Why the line named was not used. Only on status 400, 401, 403, 409, 429, 500 and 504.
curl -X POST 'https://api.navo24.com/v1/tracking/webhooks' \
-H "Authorization: Bearer tmcp_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://hooks.example.com/trackingmcp","event_types":["api_change_announced"],"description":"Integration alerts, on-call channel"}'const res = await fetch("https://api.navo24.com/v1/tracking/webhooks", {
method: "POST",
headers: {
"Authorization": "Bearer tmcp_YOUR_API_KEY",
"Content-Type": "application/json"
},
body: JSON.stringify({
"url": "https://hooks.example.com/trackingmcp",
"event_types": [
"api_change_announced"
],
"description": "Integration alerts, on-call channel"
})
});
const data = await res.json();import requests
res = requests.post(
"https://api.navo24.com/v1/tracking/webhooks",
headers={"Authorization": "Bearer tmcp_YOUR_API_KEY"},
json={
"url": "https://hooks.example.com/trackingmcp",
"event_types": [
"api_change_announced"
],
"description": "Integration alerts, on-call channel"
},
)
data = res.json(){
"api_version": "2026-08-04",
"ok": true,
"data": {
"id": "3f1c9a4e-7b52-4f0e-9a41-2c9d5e6b8a10",
"url": "https://example.com/navo-docs-capture",
"event_types": [],
"description": "Docs capture, staging only",
"active": true,
"created_at": "2026-08-19T15:07:46.481165+00:00",
"secret": "whsec_0000000000000000000000000000000000000000000000000"
}
}