How to configure EasyPost V2 carrier connections (EASYPOSTV2) in techSHIP [Guide]
Last updated: November 13, 2026
EasyPost V2 provides separate carrier-specific connections. Select the applicable carrier connection based on the carrier account that will be used for rating and shipment processing.
This guide explains how to add and configure this carrier connection, review its available carrier-specific settings, and understand the shipment requirements and operational constraints that apply.
Carrier Requirements and Specifications
This section summarizes onboarding requirements and lists confirmed carrier-specific constraints.
To review all supported carriers and their specific requirements, see: 📄 techSHIP supported Carriers - Master List [Guides List].
Onboarding Requirements
The EasyPost V2 integrations support:
Rate Shopping
Tracking History
Void, where supported by the selected carrier
Time in Transit, when delivery estimates are returned by the carrier
Flexible Address Validation
Return Labels, where supported by the selected carrier and service
Label References
Signature Required, where supported by the selected carrier and service
Collect (COD), where supported by the selected carrier and service
Information to be Provided
The following credentials and data points may be required to connect an EasyPost V2 carrier connection. Requirements vary by selected carrier.
DATA ELEMENT | SOURCE (HOW TO OBTAIN) |
|---|---|
Registration details | Prepare the customer and sender information required by the Register workflow. Registration supplies the EasyPost customer and API credentials. |
Carrier credentials or provisioned account | Obtain the applicable credentials listed in Carrier Connections, or arrange the carrier account through EasyPost when the connection uses an EasyPost-provisioned account. |
Carrier account IDs (comma separated) | Use the applicable EasyPost carrier account identifiers to restrict rating and label purchases to the intended carrier accounts. |
Shipment data | Prepare accurate addresses, positive package weights, complete dimensions when required, and customs items for international shipments. |
Specifications and Constraints
Carrier Connections
Select and configure the carrier-specific EasyPost connection that corresponds to the carrier account being used.
CARRIER | PLUGIN CODE | CONNECTION REQUIREMENTS |
|---|---|---|
OSM Worldwide V2 |
| Provide the OSMWorldwideV2 API Key, OSMWorldwideV2 Rating Key, OSMWorldwideV2 Mailer ID, and OSMWorldwideV2 Client ID. |
Maersk |
| Provide the Account Number and Account Key. Use the account applicable to the shipment origin. |
DHL eCommerce |
| Provide the DHL eCommerce client ID, DHL eCommerce client secret, DHL eCommerce pickup ID, and DHL eCommerce distribution center. |
DHL Express |
| Provide the DHL Account Number. Site ID and Password may also apply to the connected account. The account country comes from the sender address. |
Canada Post |
| Provide the CanadaPost API Key, CanadaPost Customer Number, and CanadaPost Contract ID when using a contract account. |
Better Trucks |
| Provide the Better Trucks API Key. |
FedEx |
| Use the applicable EasyPost FedEx account and configure its Carrier account ID. The split uses the EasyPost |
UPS DAP |
| Use the applicable EasyPost-provisioned account and configure its Carrier account ID. No UPS DAP carrier credential fields are collected by this connection. |
SmartKargo |
| Provide the SmartKargo Account Number. |
SpeedX |
| Provide the SpeedX API Key and SpeedX Pickup Account Number. A separate carrier account may be required for each shipment origin/hub. |
Veho |
| Provide the Veho Production API Key. |
USPS |
| Complete the sender company/address, phone, and email used for the USPS account. Provide the Shipper ID when applicable. |
UniUni |
| Provide the Customer Number, Client ID, Client Secret, and Pickup Warehouse. |
Operational Details
Each carrier-specific connection rates and purchases shipments using only its corresponding carrier. When Carrier account IDs are configured, rating and purchasing are further restricted to those accounts.
Leaving Carrier account IDs blank can allow another eligible account for the same carrier to return rates; it does not allow the connection to fall back to a different carrier.
Available services depend on the connected carrier account, shipment route, and carrier eligibility. A service appearing in the integration does not guarantee that it is available to every account or destination.
Some carrier connections have additional operational requirements or limitations:
Amazon Shipping: use an eligible Amazon Shipping account. Amazon Marketplace-specific shipment data requiring
fulfiller_order_itemsis not mapped by this integration.OSM Worldwide V2: carrier voiding is not supported. Do not assume that an EasyPost refund request can cancel an OSM shipment.
Maersk: use an account appropriate for the shipment origin. Services can depend on the rates returned by the connected account.
DHL eCommerce: separate return shipments are not supported by this connection.
FedEx: the connection filters rates to the applicable EasyPost FedEx carrier account and service. Configure the intended Carrier account ID when account isolation is required.
SpeedX: the Pickup Account Number identifies the applicable origin/hub; separate accounts can be required for different shipment origins.
USPS: the connection is restricted to USPS services. USPS variable-size parcels require package dimensions unless a predefined package supplies them. Dry ice is not supported.
UniUni: the available service exposed by this connection is Standard.
Manifest exceptions: OSM Worldwide V2, Maersk, DHL Express, Better Trucks, and SmartKargo do not use the shared EasyPost manifest workflow. For carrier connections where manifest support is available, the carrier must still accept the applicable scan-form request.
Returns: return availability depends on the selected carrier and service. DHL eCommerce does not support separate return shipments through this integration.
Void: Void submits a refund request to EasyPost and remains subject to the carrier's refund and cancellation rules. OSM Worldwide V2 does not support carrier voiding.
For international shipments, customs items require:
positive Quantity;
positive Unit Price;
Description;
Country of Origin.
For qualifying consumer imports into the EU processed from November 1, 2026, each applicable item must also include:
SKU;
Manufacturer Product Identifier.
Supply the actual UPC when available. Product identifier values are trimmed and limited to 64 characters.
Configuring a Baseline Account
A Baseline Account serves as the fundamental connection point between techSHIP and the carrier's system. It acts as a template that holds the credentials and fundamental properties required to process shipments.
The techSHIP AI Assistant is available from the Carrier page for supported Carrier configuration tasks. For detailed conceptual information and advanced configuration, refer to 📄 techSHIP AI Assistant: Overview & Availability [Information].
Adding a Carrier
Before adding an account, you must ensure the Carrier entity is available for your location.
Click My Carriers from the left menu under the Carriers category.
Click Add Carrier.

Select the desired Carrier.
You may encounter additional messages depending on the carrier status or your plan:
Subscription Required (⭐): If the carrier has a star icon, you will see a message stating "To use this carrier, a subscription upgrade is required." Press Contact to Upgrade to proceed.

Carrier Suspended: If the carrier has not been used for an extended period, you will see a message stating “This carrier is currently on hold...” Click Request Assistance to reactivate it.

Setup Fee Waived: If a carrier from the same carrier group is already installed in your location, you can add this carrier without incurring additional fees.

If needed, update the carrier Name.
Click Add Carrier.

If the purchase confirmation appears, complete the following steps:
Review the purchase notice and any applicable charge information.
Optionally enter a PO Number.
Select I am authorized to complete this purchase on behalf of my organization.
Click Purchase to confirm the Carrier addition.

Once the Carrier is added, you will be automatically redirected to the Carrier page to continue setting it up.
Enter the Code of the Carrier as it appears in your host system.
The Code of the Carrier must match exactly the value defined in the host system. Any discrepancy (including casing or extra spaces) may prevent the carrier from working correctly.
Click Save.

If your facility utilizes the centralized Pickup Schedule, we highly recommend adding this new carrier to your calendar now. While not required to process labels, this ensures accurate induction metrics for your Insights dashboards. To learn more, see 📄 Understanding the Centralized Pickup Schedule & Expected Induction Logic [Information].
Adding a Baseline Account
From the Carrier page, click Add Account to create a new Baseline Account.

You will be redirected to the Baseline Account page to complete the setup.
Entering incorrect values will prevent the system from generating shipping labels.
General Tab
In the General tab, define the administrative properties:

Name: Enter a descriptive name for the account.
Enter a descriptive name based on unique properties. E.g.:
Carrier Name - Account Number (CarrierX - 123456789)
Carrier Name - Consolidator Name (CarrierY - MyConsolidator)
Carrier Name
Usage: Select the most suitable option:
Test: Used for sandbox or onboarding purposes.
Production: Used for live shipping.
Keep the Status field set to its default Active value. An account must be Active to remain fully editable. For detailed conceptual information on account statuses, refer to 📄 How to Inactivate and Activate a Carrier Baseline Account [Step-by-Step Guide].
Carrier Tab
Create and save the Baseline Account for the selected carrier connection.
Use Register to complete the EasyPost customer setup.
Complete any carrier-specific credential fields that appear for the selected connection.
Save the account and review any connection error.
Verify Carrier account IDs (comma separated) against the intended carrier account when account restriction is required.
Complete the sender address, Phone, and Email.
Use Skip EasyPost manifest on finalize when the selected carrier workflow should not request an EasyPost manifest.
Labels Tab
The EasyPost V2 connections support PDF, PNG, and ZPL label requests.
The selected carrier and service must support the requested label format. Labels are retrieved after purchase using the label URL returned by EasyPost.
Finalizing the Setup
Once you have entered the required information, click Save.

After you save the Baseline Account, check whether the Registration tab or a registration status badge is available.

If neither is available, the Carrier does not use this Registration workflow in techSHIP. If registration is still pending, open the Registration tab and press Registration, then complete 📄 How to Register a Carrier Baseline Account [Step-by-Step Guide] before creating shipments.
From the Carrier page, you can now see the Baseline Account listed with the administrative status Active. The Active status is separate from the account's registration status.

The Baseline Account configuration is now saved. You can continue with Configuring a Client Account below to assign the Baseline Account to a specific Client.
Configuring a Client Account
Adding an Account
Before adding a Client Account, ensure that the Client has been created. For instructions creating a Client, see: 📄 10 - How to create a Client profile [Step-by-Step guide].
Click Clients from the left menu under the Clients section.
Click the Edit icon for the desired Client.

Click Add Accounts.

Optionally, use the Search box to search by Baseline Account Name or Carrier.
Select the Baseline Accounts that will serve as the foundation for your new Client Accounts.
Click Add Accounts.

A toast notification will confirm the accounts were successfully assigned. Click the Refresh icon if recently added accounts are not displayed.

Click Edit on each newly created account.

Configure the available options in each tab (except Carrier).

For complete instructions on configuring this settings, see 📄 How to configure the Billing Account General Options tab [Step-by-Step guide].
Carrier Tab
Configure the carrier-specific Client Account settings as applicable:
Service code: Select the service applicable to the selected carrier connection.
Package type: Select an applicable package type when one is provided by the carrier.
Override WMS service code: Enable to replace the service received from the Integrated system.
Default currency: Set the normal shipment currency.
Default contents description: Set the normal contents description for applicable shipments.
Default reason for export: Set the normal export reason for international shipments.
Address validation: Select Strict or Disabled.
Allow partial rate success: Enable when rates from successful packages should remain available when another package fails rating.
Electronically certify customs information: Enable when the sender can certify the customs information.
Default shipper type: Set the applicable shipper party type.
Default receiver type: Set the applicable receiver party type.
Incoterm: Configure the normal international Incoterm when applicable.
Duty Payment Account: Configure the account used for applicable DDP shipments.
Configure sender and return-address overrides when required.
For DHL eCommerce, populate Merchant Id when required by the connected account.
For USPS (EASYPOSTUSPSV2), Incoterm and Duty Payment Account are not used by this connection.
Specifying Rate Shopping Service Codes
Use a service belonging to the selected carrier connection.
Bare service codes resolve within that carrier connection. When a qualified Carrier|Service value is used, the carrier portion must identify the same carrier as the selected connection.
For detailed instructions on how to configure this, see: Include or exclude Service Codes when Rate Shopping [Step-by-Step Guide].
Label References
Configure Reference 1, Reference 2, and Reference 3 in the Client Account's General tab under Labels.
These values map to the three custom-print references sent to EasyPost. Whether each reference appears on the physical label depends on the selected carrier's label layout.
Reference 4 is not sent by this integration.
For a comprehensive guide on how to use label references, see: Using order References in your labels [Step-by-Step guide].
Finalizing the Setup
Once you have entered the required information, click Save.

With the account configured and requirements verified, you can now proceed to process orders as described below.
Configuring an Order
The steps described in this section are not required for carrier setup, and they are offered as an optional review if further order-level configuration is required.
Follow the UI Navigation steps in 📄 05 - How to edit an order’s information - [Step-by-Step guide], using the carrier-specific values provided in this guide.
In the Order's carrier-specific settings, review the applicable values:
Service code
Ship date
Residential delivery
Currency
Skip strict address validation
Configure the following only when supported by the selected carrier and service:
Return shipment
signature options;
EasyPost insurance;
Declared value;
Collect on delivery amount;
Collect on delivery method;
Dry ice.
When Dry ice is enabled, provide a positive dry-ice weight. Dry ice is not supported by the USPS connection.
For international shipments, complete the applicable:
Reason for export;
Contents description;
tax identifiers;
Receiver type.
An Order-level Incoterm override uses the Order's Duty Payment Account. The Client Account duty-payment account is not used as a fallback for an Order-level Incoterm override.
Duty terms are omitted for:
USPS (
EASYPOSTUSPSV2) and USPS services;domestic shipments;
applicable United States territory destinations shipped from the United States;
applicable military-address shipments from the United States.
For a non-USPS international DDP shipment, a missing Duty Payment Account does not prevent Rate Shopping, but it must be provided before the label is purchased.
Click Save to apply the order-level changes. After the Order is updated, continue with the standard shipping workflow.
Troubleshooting
No EasyPost API key is available: Complete Register on the Baseline Account and save the connection.
Carrier credential fields are missing: Complete registration first, then reopen the Baseline Account and verify the fields applicable to the selected carrier connection.
No eligible rate is returned or the service is unavailable: Verify the selected carrier connection, Carrier account IDs, service, route, and carrier-account eligibility. The connection does not use another carrier as a fallback.
The wrong carrier account is returning rates: Configure the intended EasyPost Carrier account ID so rating and purchase are restricted to that account.
USPS parcel rating requires dimensions: Provide Length, Width, and Height unless the selected predefined USPS package supplies fixed dimensions.
USPS shipment contains dry ice: Remove the dry-ice option or use a carrier/service that supports the required shipment.
International label is rejected: Verify customs-item quantity, value, description, country of origin, Reason for export, product identifiers when required, and the applicable duty-payment configuration.
A non-USPS DDP label cannot be purchased: Provide the Duty Payment Account on the Order when the Order contains the Incoterm override, or on the Client Account when the Client Account supplies the DDP configuration.
OSM Worldwide V2 shipment cannot be voided: OSM does not support carrier voiding through this integration. Review the carrier's available cancellation or refund process instead.
DHL eCommerce return workflow is unavailable: This connection does not support separate return shipments.
Insurance value error: Supply a positive Declared value for each applicable package when insurance is enabled.
Label purchase succeeded but label download failed: Retrieve the existing shipment's label before attempting another purchase.
Some packages processed while others failed: Review the successfully purchased packages before retrying the failed shipment data.
Manifest is unavailable for OSM Worldwide V2, Maersk, DHL Express, Better Trucks, or SmartKargo: These connections do not use the shared EasyPost manifest workflow.
Manifest is still processing for a supported connection: Retrieve the existing scan form again after EasyPost completes processing; do not create a duplicate manifest solely because the PDF is not immediately available.
Refund request is rejected: Review the selected carrier's refund eligibility and conditions. An EasyPost refund request does not guarantee carrier cancellation or reimbursement.