EasyPost - Track Shipment

Description

This module gets the tracking status of a shipment in EasyPost. It supports two query modes: by tracker ID (trk_…) making a GET request to the /trackers/{tracker_id} endpoint, or by carrier tracking code making a POST request to /trackers to create a tracker. It processes the response to extract the status, carrier, estimated delivery date, signer, public tracking URL, and the detailed event history with status, message, date, city, state, and country.

Configuration

Parameter	Type	Required	Description
credentials_id	credentials	Yes	EasyPost credential (provider: easypost)
tracker_id	text	No	EasyPost tracker ID (trk_…)
tracking_code	text	No	Carrier tracking number
carrier	text	No	Carrier name (required if using tracking_code)

Credentials

A easypost type credential is required with the following fields:

api_key: EasyPost API Key

Output

{
  "success": true,
  "tracker_id": "trk_abc123",
  "tracking_code": "9400111899223456789012",
  "carrier": "USPS",
  "status": "in_transit",
  "est_delivery_date": "2026-03-25T18:00:00Z",
  "signed_by": null,
  "tracking_details": [
    {
      "status": "in_transit",
      "message": "In transit to next facility",
      "datetime": "2026-03-23T10:30:00Z",
      "city": "San Francisco",
      "state": "CA",
      "country": "US"
    }
  ],
  "public_url": "https://track.easypost.com/...",
  "message": "Estado: in_transit - 9400111899223456789012"
}

Usage Example

Basic case

{
  "credentials_id": "mi_credencial_easypost",
  "tracker_id": "trk_abc123"
}

API Used

Endpoint: GET /trackers/{tracker_id} or POST /trackers
Base: EasyPost API (via helper _easypostHelper)
Documentation: https://www.easypost.com/docs/api

Notes

At least one of tracker_id or tracking_code is required
If using tracking_code, it is recommended to include the carrier for greater accuracy
The public_url provides a public tracking page that can be shared with the customer
The signed_by field is populated when the package is delivered and signed for