n8n-nodes-easypost

[Velocity BPA Licensing Notice]

This n8n node is licensed under the Business Source License 1.1 (BSL 1.1).

Use of this node by for-profit organizations in production environments requires a commercial license from Velocity BPA.

For licensing information, visit https://velobpa.com/licensing or contact [email protected].

An n8n community node for integrating with EasyPost's shipping and logistics API. This node provides access to 10 core resources including address validation, shipment creation, rate comparison, package tracking, and customs documentation. Streamline your shipping workflows with comprehensive parcel management and real-time tracking capabilities.

Features

Address Validation - Verify and standardize shipping addresses with comprehensive validation and suggestion capabilities

Shipment Management - Create, retrieve, and manage shipments with full lifecycle support and label generation

Rate Comparison - Compare shipping rates across multiple carriers to find the most cost-effective options

Package Tracking - Real-time tracking of shipments with detailed status updates and delivery confirmations

Batch Processing - Handle multiple shipments efficiently with batch creation and bulk operations

Customs Documentation - Generate and manage customs forms for international shipping compliance

Insurance Integration - Add shipping insurance with flexible coverage options and claims management

Event Monitoring - Track shipping events and status changes with webhook support and real-time notifications

Installation

Community Nodes (Recommended)

1. Open n8n
2. Go to Settings → Community Nodes
3. Click Install a community node
4. Enter n8n-nodes-easypost
5. Click Install

Manual Installation

cd ~/.n8n
npm install n8n-nodes-easypost

Development Installation

git clone https://github.com/Velocity-BPA/n8n-nodes-easypost.git
cd n8n-nodes-easypost
npm install
npm run build
mkdir -p ~/.n8n/custom
ln -s $(pwd) ~/.n8n/custom/n8n-nodes-easypost
n8n start

Credentials Setup

| Field | Description | Required | |-------|-------------|----------| | API Key | Your EasyPost API key (test or production) | Yes | | Environment | Select test or production environment | Yes |

Resources & Operations

1. Address

| Operation | Description | |-----------|-------------| | Create | Create and validate a new address | | Get | Retrieve an existing address by ID | | Verify | Verify and get suggestions for an address | | List | List all addresses in your account |

2. Parcel

| Operation | Description | |-----------|-------------| | Create | Create a new parcel with dimensions and weight | | Get | Retrieve an existing parcel by ID | | List | List all parcels in your account |

3. Shipment

| Operation | Description | |-----------|-------------| | Create | Create a new shipment with addresses and parcel | | Get | Retrieve an existing shipment by ID | | Buy | Purchase a shipping label for a shipment | | Regenerate | Regenerate tracking codes for a shipment | | List | List all shipments in your account |

4. Rate

| Operation | Description | |-----------|-------------| | Get | Retrieve a specific rate by ID | | List | List all available rates for a shipment |

5. Tracker

| Operation | Description | |-----------|-------------| | Create | Create a new tracker for a tracking code | | Get | Retrieve an existing tracker by ID | | List | List all trackers in your account | | Update | Update tracker information |

6. Batch

| Operation | Description | |-----------|-------------| | Create | Create a new batch for multiple shipments | | Get | Retrieve an existing batch by ID | | Buy | Purchase labels for all shipments in a batch | | Generate Label | Generate consolidated labels for a batch | | List | List all batches in your account |

7. CustomsItem

| Operation | Description | |-----------|-------------| | Create | Create a new customs item declaration | | Get | Retrieve an existing customs item by ID | | List | List all customs items in your account |

8. CustomsInfo

| Operation | Description | |-----------|-------------| | Create | Create customs information for international shipments | | Get | Retrieve existing customs information by ID | | List | List all customs info records in your account |

9. Insurance

| Operation | Description | |-----------|-------------| | Create | Create insurance coverage for a shipment | | Get | Retrieve existing insurance information by ID | | List | List all insurance records in your account |

10. Event

| Operation | Description | |-----------|-------------| | Get | Retrieve a specific event by ID | | List | List all events in your account | | Retrieve Payload | Get the full payload for a webhook event |

Usage Examples

// Create and validate an address
{
  "street1": "354 Main St",
  "street2": "Suite 100",
  "city": "San Francisco",
  "state": "CA",
  "zip": "94105",
  "country": "US",
  "company": "EasyPost",
  "phone": "415-456-7890"
}

// Create a shipment with rate comparison
{
  "to_address": {
    "name": "John Doe",
    "street1": "417 Montgomery Street",
    "city": "San Francisco",
    "state": "CA",
    "zip": "94104",
    "country": "US"
  },
  "from_address": {
    "name": "Jane Smith", 
    "street1": "354 Main St",
    "city": "San Francisco",
    "state": "CA",
    "zip": "94105",
    "country": "US"
  },
  "parcel": {
    "length": 10,
    "width": 8,
    "height": 4,
    "weight": 15
  }
}

// Track a package by tracking code
{
  "tracking_code": "EZ1000000001",
  "carrier": "USPS"
}

// Create customs information for international shipping
{
  "customs_certify": true,
  "customs_signer": "John Doe",
  "contents_type": "merchandise",
  "contents_explanation": "T-shirt purchase",
  "eel_pfc": "NOEEI 30.37(a)",
  "non_delivery_option": "abandon",
  "restriction_type": "none",
  "customs_items": [
    {
      "description": "T-shirt",
      "quantity": 1,
      "value": 25.00,
      "weight": 5,
      "origin_country": "US",
      "hs_tariff_number": "6109.10.0012"
    }
  ]
}

Error Handling

| Error | Description | Solution | |-------|-------------|----------| | Invalid API Key | The provided API key is invalid or expired | Verify your API key in EasyPost dashboard and update credentials | | Address Validation Failed | The provided address could not be validated | Check address format and use address verification before shipment creation | | Insufficient Postage | The selected rate is no longer available | Refresh rates and select a currently available option | | Tracking Not Found | The tracking code does not exist or is invalid | Verify tracking code format and ensure it has been generated | | Rate Limit Exceeded | Too many API requests in a short period | Implement exponential backoff and respect rate limiting | | Invalid Parcel Dimensions | Parcel dimensions exceed carrier limits | Check carrier restrictions and adjust package dimensions |

Development

npm install
npm run build
npm test
npm run lint
npm run dev

Author

Velocity BPA

• Website: velobpa.com
• GitHub: Velocity-BPA

Licensing

This n8n community node is licensed under the Business Source License 1.1.

Free Use

Permitted for personal, educational, research, and internal business use.

Commercial Use

Use of this node within any SaaS, PaaS, hosted platform, managed service, or paid automation offering requires a commercial license.

For licensing inquiries: [email protected]

See LICENSE, COMMERCIAL_LICENSE.md, and LICENSING_FAQ.md for details.

Contributing

Contributions are welcome! Please ensure:

1. Code follows existing style conventions
2. All tests pass (npm test)
3. Linting passes (npm run lint)
4. Documentation is updated for new features
5. Commit messages are descriptive

Support

• Issues: GitHub Issues
• EasyPost API Documentation: EasyPost API Docs
• EasyPost Developer Community: EasyPost Support