Webhooks
Let Cargobase push events to your HTTPS endpoint as shipments and tracking updates unfold.
Some integrations work best when Cargobase calls you. Webhooks deliver events—tracking updates, for example—to an HTTPS endpoint you control, so you do not have to poll for changes.
Basics
- Expose a publicly reachable HTTPS endpoint.
- Register that URL with Cargobase (the exact process depends on the product—see the Webhooks collection).
- Verify signatures or shared secrets when the OpenAPI document describes them.
- Respond quickly with
2xx, and move heavy work off the request thread.
Open the Webhooks collection under Shipper or Provider to inspect event payloads. Download the OAS if you want generated types for those bodies.