Skip to content
Documentation sections

June 2025

Shipment Management API

AddedShipment Management

From 3 June 2025, the Shipment Management API manages the shipments of a Safecube workspace from your own systems, such as a TMS or an ERP:

  • POST /public/shipments creates shipments, asynchronously;
  • DELETE /public/shipments deletes shipments;
  • POST /public/shipments/search returns shipments with their public sharing links, which open the tracking of a shipment without login.

Every request is authenticated with the API key of the workspace in the API_KEY header.

The API is described in Getting started with the Shipment Management API, and the embedding of a public sharing link in Embed a shipment in an iframe.

White label

AddedPlatform

White label brands Safecube with your company. It has two parts: a custom logo, shown in the app and on shared tracking pages, and a custom URL, a subdomain such as yourcompany.safecube.ai that replaces app.safecube.ai.

An Admin uploads the logo in Settings, on the General page. The Owner requests a new custom URL, which the Safecube team sets. Both are options that the Safecube team activates on a workspace.

White label is described in White label.

Split bill of lading warning and webhook event

AddedContainer TrackingWebhooks

From 12 June 2025, Safecube flags a bill of lading or a booking that may be split: within the same bill of lading, the events differ from one container to another.

In the Container Tracking API, metadata.warnings of GET /shipment then contains SPLIT_BL. In the Webhooks API, the shipment.warning.split_bl event is sent once for all the containers of the shipment, and not again unless the events converge and then diverge again.

To be warned by webhook, add shipment.warning.split_bl to the filterTypes of the endpoint.

The event is described in Webhook events, and the warning in Retrieve shipment tracking data.

Webhook events grouped by category

ImprovedPlatform

When a webhook is created or edited in the app, the events to choose from are grouped by category.

The categories are described in Webhooks console.

Comments, sharing and replacement of documents

ImprovedPlatform

The Document viewer of a document shows its Comments: write in Comment, then select Add comment. Typing @ in a comment lists the users of the workspace, to mention one of them.

Share document, in the viewer, creates a link to the file, copied with Copy link. More options > Replace document, in the viewer, replaces the file and keeps the document.

Documents are described in Documents.

Notes become Tasks

ImprovedPlatform

On 17 June 2025, notes were renamed Tasks. From 24 June 2025, a task had a status, which could also be changed from its row in the list of tasks.

The Tasks feature was withdrawn from the app on 21 July 2025.

Vessel tracking page

AddedPlatform

A vessel tracking page searches a vessel and shows its position on a map and its characteristics. From the event timeline of a shipment, the name of a vessel opens its page.

The vessel tracking page was withdrawn from the app in November 2025.

Analytics page

AddedPlatform

The Analytics page, opened from Analytics in the sidebar, sums up the performance of the shipments of the workspace.

It shows how many shipments are in transit, delivered or delayed, the share of containers that arrived early, on time or late, the delayed rate of each carrier, and the most common and the most delayed routes with their average transit time. Every figure is computed by Safecube.

The page is described in Performance analytics.

Incomplete tab and status withdrawn

RemovedPlatform

The Incomplete tab and the Incomplete status were withdrawn from the shipment list on 23 June 2025.

Fixes

FixedPlatform
  • Shipments without a port of loading or a port of discharge display in the shipment list.
  • A webhook with empty metadata can be edited in the app.
  • A document without a category displays in the Documents block.