shipment.tracking.checkpointscreated

When your shipment's checkpoints increased, you'll get the event payload as below:

{
  "event_type": "shipment.tracking.checkpoints.created",
  "resource_type": "shipment",
  "resource_id": "ESTEST00000",
  "data": {
    "easyship_shipment_id": "ESTEST00000",
    "platform_order_number": "#100001",
    "origin": "US",
    "destination": "CA",
    "company_order_number": "#100001",
    "status": "Delivered",
    "tracking_number": "12345",
    "tracking_page_url": "https://www.trackmyshipment.co/shipment-tracking/ESTEST00000",
    "checkpoints": [
      {
        "order_number": 102,
        "handler": "Usps",
        "message": "Arrived at Regional Facility",
        "location": "CITY, STATE, 12345, USA",
        "city": "CITY",
        "country_name": "United States", 
        "country_iso3": "USA",
        "state": "STATE",
        "postal_code": "12345",
        "checkpoint_time": "2025-01-01T12:00:00.000Z",
        "primary_status": "In Transit to Customer"
      },
      {
        "order_number": 109,
        "handler": "Usps",
        "message": "Arrived at Post Office",
        "location": "CITY, STATE, 12345, USA",
        "city": "CITY",
        "country_name": "United States", 
        "country_iso3": "USA",
        "state": "STATE",
        "postal_code": "12345",
        "checkpoint_time": "2025-01-02T10:00:00.000Z",
        "primary_status": "In Transit to Customer"
      },
      {
        "order_number": 112,
        "handler": "Usps",
        "message": "Delivered, In/At Mailbox",
        "location": "CITY, STATE, 12345, USA",
        "city": "CITY",
        "country_name": "United States", 
        "country_iso3": "USA",
        "state": "STATE",
        "postal_code": "12345",
        "checkpoint_time": "2025-01-03T08:00:00.000Z",
        "primary_status": "Delivered"
      }
    ]
  }
}

Here is the details of each fields.

Field NameData TypeDescription
event_typeStringThe type of event that triggered this webhook notification. In this case, it indicates new tracking checkpoints have been created for a shipment.
resource_typeStringThe type of resource that this event pertains to. Here, it's a shipment.
resource_idStringThe unique identifier of the specific shipment resource.
dataObjectAn object containing the details of the shipment and the newly created tracking checkpoints.
data.easyship_shipment_idStringEasyship shipment ID.
data.platform_order_numberStringThe order number associated with this shipment from the e-commerce platform.
data.originStringCountry Code in Alpha-2 format (ISO 3166-1).
data.destinationStringCountry Code in Alpha-2 format (ISO 3166-1).
data.company_order_numberStringThe order number assigned to this shipment by the company or seller.
data.statusStringThe current overall status of the shipment (e.g., "Delivered").
data.tracking_numberStringThe tracking number assigned to the shipment by the carrier.
data.tracking_page_urlStringA URL that leads to a tracking page where more detailed information about the shipment can be found.
data.checkpointsArrayAn array of checkpoint objects, each representing a specific event in the shipment's journey.
data.checkpoints[].order_numberIntegerA sequential number indicating the order of this checkpoint in the shipment's history.
data.checkpoints[].handlerStringThe name of the shipping carrier or handler responsible for this checkpoint (e.g., "USPS").
data.checkpoints[].messageStringA brief message describing the event at this checkpoint (e.g., "Arrived at Regional Facility").
data.checkpoints[].locationStringA string containing the location details of this checkpoint, often including city, state, and postal code.
data.checkpoints[].cityStringThe city where this checkpoint occurred.
data.checkpoints[].country_nameStringThe full name of the country where this checkpoint occurred (e.g., "United States").
data.checkpoints[].country_iso3StringThe ISO 3166-1 alpha-3 code for the country (e.g., "USA").
data.checkpoints[].stateStringThe state or province where this checkpoint occurred.
data.checkpoints[].postal_codeStringThe postal or zip code of the location.
data.checkpoints[].checkpoint_timeStringThe timestamp indicating when this checkpoint event occurred, in ISO 8601 format (UTC).
data.checkpoints[].primary_statusStringA high-level status category for this specific checkpoint (e.g., "In Transit to Customer", "Delivered").