EasyPost - Get Rates

Description

This module gets shipping rates from multiple carriers by creating a Shipment in EasyPost. It receives the origin and destination addresses in JSON format along with the package specifications (dimensions in inches, weight in ounces). It makes a POST request to the /shipments endpoint and processes the response to extract available rates with ID, carrier, service, price, currency, delivery days, and estimated date. It automatically identifies the cheapest and fastest rates.

Configuration

Parameter	Type	Required	Description
credentials_id	credentials	Yes	EasyPost credential (provider: easypost)
from_address	textarea	Yes	Origin address in JSON (name, street1, city, state, zip, country)
to_address	textarea	Yes	Destination address in JSON (name, street1, city, state, zip, country)
parcel	textarea	Yes	Package in JSON (length, width, height in inches; weight in ounces)

Credentials

A easypost type credential is required with the following fields:

api_key: EasyPost API Key

Output

{
  "success": true,
  "shipment_id": "shp_abc123",
  "rates": [
    {
      "rate_id": "rate_abc123",
      "carrier": "USPS",
      "service": "Priority",
      "rate": "7.58",
      "currency": "USD",
      "delivery_days": 2,
      "delivery_date": "2026-03-25",
      "est_delivery_days": 2
    }
  ],
  "rates_count": 8,
  "cheapest": {
    "rate_id": "rate_def456",
    "carrier": "USPS",
    "service": "First",
    "rate": "4.50",
    "currency": "USD"
  },
  "fastest": {
    "rate_id": "rate_ghi789",
    "carrier": "FedEx",
    "service": "FEDEX_2_DAY",
    "rate": "15.20",
    "delivery_days": 1
  },
  "message": "8 tarifas obtenidas"
}

Usage Example

Basic case

{
  "credentials_id": "mi_credencial_easypost",
  "from_address": "{\"name\":\"Mi Empresa\",\"street1\":\"123 Main St\",\"city\":\"San Francisco\",\"state\":\"CA\",\"zip\":\"94105\",\"country\":\"US\"}",
  "to_address": "{\"name\":\"Cliente\",\"street1\":\"456 Oak Ave\",\"city\":\"Los Angeles\",\"state\":\"CA\",\"zip\":\"90001\",\"country\":\"US\"}",
  "parcel": "{\"length\":10,\"width\":8,\"height\":4,\"weight\":16}"
}

API Used

Endpoint: POST /shipments
Base: EasyPost API (via helper _easypostHelper)
Documentation: https://www.easypost.com/docs/api

Notes

Package dimensions are expressed in inches and weight in ounces
The returned shipment_id is needed to buy a rate with the Buy Shipment node
EasyPost adds carriers connected to your account, including USPS, FedEx, UPS, and others
The cheapest and fastest fields are calculated automatically