Connect your system
Your gate system, warehouse software, truck GPS or control tower can send updates to CargoMo with one web call. It works from any language: PHP and Laravel, Java, .NET, Python or Node. Nothing to install on your side.
You keep your system. CargoMo adds the last mile.
Most cargo companies already have software they trust. CargoMo does not ask you to replace it. Your system keeps running the dock, the warehouse or the planning. It sends CargoMo the events it already knows, like gate in, docked or sealed.
CargoMo adds what usually happens outside your system: the truck driver's phone, partners without software, live position, delays with a reason, damage photos, and a tracking link for the customer.
If you later want to move a part of your old system into CargoMo, it can be done one piece at a time while both keep running.
From no code to a full connection
One web call per event
Each system that sends updates is a data source in CargoMo, with its own key. An admin adds it under Air or Water, then Data sources. A key can be changed at any time, and the old one stops working at once.
// One update
{ "ok": true, "ref": "AX-2058", "leg": 2, "event": "gate_in" }
// A refused update, with the reason in plain words
{ "ok": false, "error": "Part 1 of AX-2058 has not finished yet, so part 2 cannot finish." }
// Many updates: one result for each, in the same order (HTTP 207 if some failed)
{ "results": [ { "ok": true, ... }, { "ok": false, "error": "..." } ] }What your system can tell us
Copy, change the key, send
curl -X POST https://your-cargomo-address/api/air/ingest \
-H "Authorization: Bearer YOUR_SOURCE_KEY" \
-H "Content-Type: application/json" \
-d '{ "shipment": "176-12345675", "event": "gate_in",
"at": "2026-11-16T09:42:00Z", "text": "Truck NL-82-BX at gate 3" }'use Illuminate\Support\Facades\Http;
// For example in a listener on your own GateEvent model.
$response = Http::withToken(config('services.cargomo.key'))
->post(config('services.cargomo.url') . '/api/air/ingest', [
'shipment' => $awb, // "176-12345675" or "AX-2058"
'event' => 'docked', // see the list of events
'at' => now()->toIso8601String(),
'text' => "Docked at door {$door}",
]);
if (! $response->json('ok')) {
Log::warning('CargoMo update not taken', $response->json());
}await fetch(process.env.CARGOMO_URL + "/api/water/ingest", {
method: "POST",
headers: { Authorization: "Bearer " + process.env.CARGOMO_KEY, "Content-Type": "application/json" },
body: JSON.stringify({ updates: [
{ shipment: "WM-3004", event: "position", lat: 25.01, lng: 55.06 },
{ shipment: "WM-3004", event: "delay", delayMin: 240, text: "Waiting for a berth" },
] }),
});CargoMo tells your system as it happens
An admin puts the address of your system under Settings, then Updates out. From then on, every update on every shipment is sent there within a second: a driver picked up, a partner is late, damage was reported, a truck went through the gate, goods were delivered. Trucks, air and sea.
Each call is signed with a secret only you and CargoMo know, so your system can check it really came from us. There is a Send a test button to try it.
POST https://your-system.example.com/cargomo/updates
Content-Type: application/json
X-CargoMo-Signature: sha256=6f1c...e9
{
"type": "shipment.update",
"product": "air",
"shipment": "AX-2058",
"awb": "176-12345675",
"event": "problem",
"leg": 4,
"at": "2026-11-16T12:35:00.000Z",
"text": "2 boxes wet at the dock",
"by": "Rhine Road Feeder update page",
"photo": true
}// Laravel route that receives CargoMo updates
Route::post('/cargomo/updates', function (Request $request) {
$expected = 'sha256=' . hash_hmac('sha256', $request->getContent(), config('services.cargomo.secret'));
abort_unless(hash_equals($expected, $request->header('X-CargoMo-Signature', '')), 401);
$u = $request->json()->all();
// $u['shipment'], $u['awb'], $u['event'], $u['at'], $u['text'] ...
GateLog::recordFromCargoMo($u);
return response()->noContent();
});Wrong updates are refused, with the reason
Coming next, tell us what you need first
These are planned and not in CargoMo yet. If your project needs one, it moves to the front.
Try it on the demo in ten minutes
- 01Open the demo
Log in as the owner. No sign-up needed.
- 02Make a key
Go to Air, then Data sources, and add a source. Copy its key.
- 03Send one update
Use the curl example above with an AWB from the Air shipments list.
- 04See it land
Open the shipment. Your update is on the timeline with your source name, and the customer's tracking link has moved.