---
updatedAt: 2025-06-12T09:36:00.000Z
agentTools:
  projectIndex: https://documentation.safecube.ai/llms.txt
---

# Possible Events

Find below the list of supported events for our Webhook API and the corresponding triggers.

Deep dive into the each event format (schema and examples) in [our event documentation](https://www.svix.com/event-types/eu/org_2VwHMERd77Ne7QX11CHCWBUSb1u/)

<HTMLBlock>{`
<style>.rm-Guides .content-body {width: 100% !important;max-width: none !important;} .content-toc {display: none !important;}.rm-ReferenceMain .rm-Article {max-width: none;}</style>
`}</HTMLBlock>

# Operationnal Webhooks (meta-events)

Those webhooks are self sufficient to use Webhook API as a PUSH API.\
They are sent only once per shipment (not once per container) and the payload contains the information for the whole shipment.

<HTMLBlock>{`
<table style="width: 100%; border-collapse: collapse;">
<thead>
<tr>
  <th style="border: 1px solid #ddd; padding: 8px;">Event Type</th>
  <th style="border: 1px solid #ddd; padding: 8px;">Trigger</th>
  <th style="border: 1px solid #ddd; padding: 8px;">Comment</th>
</tr>
</thead>
<tbody>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p>shipment.added.to.endpoint</p>
</td>
  <td style="border: 1px solid #ddd; padding: 8px;"><p>We have received the first tracking data for this container</p>
</td>
  <td style="border: 1px solid #ddd; padding: 8px;"><p>Sent once, short after POST shipment request.</p>
</td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p>shipment.in.error</p>
</td>
  <td style="border: 1px solid #ddd; padding: 8px;"><p>We haven&#39;t received any data for this shipment, and it has been added for more than 24h.</p>
</td>
  <td style="border: 1px solid #ddd; padding: 8px;"><p>Sent once per shipment, short after POST shipment request.<br>The payload contains the detected error.</p>
</td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p>shipment.any.change</p>
</td>
  <td style="border: 1px solid #ddd; padding: 8px;"><p>One or several events of your shipment have changed since the last update.</p>
</td>
  <td style="border: 1px solid #ddd; padding: 8px;"><p>Sent once for all containers in the shipment, will be sent anytime a change is detected.</p>
</td>
</tr>
<tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p>shipment.auto.removed</p>
</td>
  <td style="border: 1px solid #ddd; padding: 8px;"><p>Your shipment has been auto removed from you tracked shipments.<br>Either it has been Delivered for more than 7 days, or a new voyage has started with this container.</p>
</td>
  <td style="border: 1px solid #ddd; padding: 8px;"><p>Sent once at shipment auto removal.<br>The payload contains the reason for the removal.</p>
</td>
</tr>
  <tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p>shipment.refresh.status.change</p>
</td>
  <td style="border: 1px solid #ddd; padding: 8px;"><p>The system's ability to refresh shipment data has changed 
<br>The latest refresh status (e.g., OK, under maintenance, no credits left) differs from the previous one.
</p>
</td>
  <td style="border: 1px solid #ddd; padding: 8px;"><p>Sent once for all containers in the shipment. Will not be sent again until the refresh status changes again.<br>The payload contains the refresh status and the previous one.</p>
</td>
</tr>
  <tr>
  <td style="border: 1px solid #ddd; padding: 8px;"><p>shipment.warning.split_bl</p>
</td>
  <td style="border: 1px solid #ddd; padding: 8px;"><p>BL might be split. 
<br>Within the same BL, the events for each container differ.
</p>
</td>
  <td style="border: 1px solid #ddd; padding: 8px;"><p>Sent once for all containers in the shipment. Will not be sent again except if the events re harmonize and re diverge.</p>
</td>
</tr>
</tbody>
</table>
`}</HTMLBlock>

# Alerts raised for specific triggers

| Event Type                                             | Trigger                                                                                                             | Related status field | Related eventCode | Related Location type |
| ------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------- | -------------------- | ----------------- | --------------------- |
| container.departure.from.final.pod                     | isActual has moved to true for the event                                                                            | CGO                  | GTOT              | POD                   |
| container.discharge.at.final.pod                       | isActual has moved to true for the event                                                                            | CDD                  | DISC              | POD                   |
| container.discharge.at.transhipment\_port              | isActual has moved to true for the event                                                                            | CDT                  | DISC              | transhipment          |
| container.loaded.at.first.pol                          | isActual has moved to true for the event                                                                            | CLL                  | LOAD              | POL                   |
| vessel.departure.from.transhipment\_port               | isActual has moved to true for the event                                                                            | VDT                  | DEPA              | transhipment          |
| container.arrival.at.first.pol                         | isActual has moved to true for the event                                                                            | CGI                  | GTIN              | POL                   |
| container.loaded.at.transhipment\_port                 | isActual has moved to true for the event                                                                            | CLT                  | LOAD              | transhipment          |
| vessel.arrival.at.final.pod                            | isActual has moved to true for the event                                                                            | VAD                  | ARRI              | POD                   |
| vessel.arrival.at.transhipment\_port                   | isActual has moved to true for the event                                                                            | VAT                  | ARRI              | transhipment          |
| vessel.departure.from.first.pol                        | isActual has moved to true for the event                                                                            | VDL                  | DEPA              | POL                   |
| container.loaded.at.pre.pol                            | isActual has moved to true for the event                                                                            |                      | LOAD              | prePOL                |
| container.discharge.at.post.pod                        | isActual has moved to true for the event                                                                            |                      | DISC              | postPOD               |
| container.departure.from.pre.pol                       | isActual has moved to true for the event                                                                            |                      | DEPA              | prePOL                |
| container.arrival.at.pre.pol                           | isActual has moved to true for the event                                                                            |                      | ARRI              | prePOL                |
| container.departure.from.post.pod                      | isActual has moved to true for the event                                                                            |                      | DEPA              | postPOD               |
| container.arrival.at.post.pod                          | isActual has moved to true for the event                                                                            |                      | ARRI              | postPOD               |
| date.changed.container.departure.from.final.pod        | Date has changed from more than 24h (positive or negative) since the previous alert sent                            | CGO                  | GTOT              | POD                   |
| date.changed.container.discharge.at.final.pod          | Date has changed from more than 24h (positive or negative) since the previous alert sent                            | CDD                  | DISC              | POD                   |
| date.changed.container.discharge.at.transhipment\_port | Date has changed from more than 24h (positive or negative) since the previous alert sent                            | CDT                  | DISC              | transhipment          |
| date.changed.container.loaded.at.first.pol             | Date has changed from more than 24h (positive or negative) since the previous alert sent                            | CLL                  | LOAD              | POL                   |
| date.changed.vessel.arrival.at.final.pod               | Date has changed from more than 24h (positive or negative) since the previous alert sent                            | VAD                  | ARRI              | POD                   |
| date.changed.vessel.arrival.at.transhipment\_port      | Date has changed from more than 24h (positive or negative) since the previous alert sent                            | VAT                  | ARRI              | transhipment          |
| date.changed.vessel.departure.from.first.pol           | Date has changed from more than 24h (positive or negative) since the previous alert sent                            | VDL                  | DEPA              | POL                   |
| date.changed.vessel.departure.from.transhipment\_port  | Date has changed from more than 24h (positive or negative) since the previous alert sent                            | VDT                  | DEPA              | transhipment          |
| date.changed.container.arrival.at.first.pol            | Date has changed from more than 24h (positive or negative) since the previous alert sent                            | CGI                  | GTIN              | POL                   |
| date.changed.container.loaded.at.transhipment\_port    | Date has changed from more than 24h (positive or negative) since the previous alert sent                            | CLT                  | LOAD              | transhipment          |
| date.changed.container.arrival.at.pre.pol              | Date has changed from more than 24h (positive or negative) since the previous alert sent                            |                      | ARRI              | prePOL                |
| date.changed.container.departure.from.pre.pol          | Date has changed from more than 24h (positive or negative) since the previous alert sent                            |                      | DEPA              | prePOL                |
| date.changed.container.loaded.at.pre.pol               | Date has changed from more than 24h (positive or negative) since the previous alert sent                            |                      | LOAD              | prePOL                |
| date.changed.container.discharge.at.post.pod           | Date has changed from more than 24h (positive or negative) since the previous alert sent                            |                      | DISC              | postPOD               |
| date.changed.container.arrival.at.post.pod             | Date has changed from more than 24h (positive or negative) since the previous alert sent                            |                      | ARRI              | postPOD               |
| date.changed.container.departure.from.post.pod         | Date has changed from more than 24h (positive or negative) since the previous alert sent                            |                      | DEPA              | postPOD               |
| container.new\.event.detected                          | A new event (single event rule = same status, eventCode and location.unlocode) has been detected for this container |                      |                   |                       |