ShipStation API Carriers US

For US-based ShipStation API accounts, you have immediate access to discounted DHL Express, USPS, and UPS shipping labels with ShipStation API Carriers. There’s no need to create and connect individual carrier accounts. Simply activate ShipStation APICarriers by adding the billing method you wish to use to purchase your labels and add funds to your ShipStation API Balance.

To learn more about our discounted rates, contact our sales team.

Requirements

  • Activate ShipStation API Carriers in your ShipStation API Account (steps included in the following section)

  • Add funds to your ShipStation API Balance

  • UPS shipments: require a Company name in the Ship From address

Activate ShipStation API Carriers

To start using ShipStation API Carriers, you must activate it by adding the payment method you wish to use for your labels. Log in to ShipStation API and do the following:

You will now see your available carriers under Setup > Carriers, where you can also find their unique Carrier IDs. You can also make a List Carriers call to view all of your Carrier IDs and available services.

Carriers Setup up with Carrier ID column highlighted for ShipEngine Carrier Accounts

Be sure to also add funds to your ShipStation API Balance so you can start purchasing your labels!

Connecting Your Own Carrier Accounts

You can also connect your own USPS (Stamps.com) or UPS accounts through the My Carrier Accounts section of the Carriers settings page.

Available Features for US ShipStation API Carriers

The US ShipStation API Carriers support the following standard features:

Common Features

Feature

GlobalPost from ShipStation API

DHL Express from ShipStation API

USPS from ShipStation API

UPS from ShipStation API

FedEx from ShipStation API

Domestic Shipping

Green checkmark. Supported feature. Yes.

US-based accounts shipping from certain regions may qualify for the GlobalPost domestic shipping service.

Red X mark. Unsupported feature. No.

Green checkmark. Supported feature. Yes.

Green checkmark. Supported feature. Yes.

Green checkmark. Supported feature. Yes.

International Shipping

Green checkmark. Supported feature. Yes.

Green checkmark. Supported feature. Yes.

Green checkmark. Supported feature. Yes.

Green checkmark. Supported feature. Yes.

Green checkmark. Supported feature. Yes.

Electronic Customs Submission*

Green checkmark. Supported feature. Yes.

Green checkmark. Supported feature. Yes.

Red X mark. Unsupported feature. No.

Green checkmark. Supported feature. Yes.

Grey dash icon. Not applicable.

For most countries, the data passes electronically to FedEx (ETD). Where ETD is not supported, the invoice needs to be printed. See Available Services.

Return Labels

Green checkmark. Supported feature. Yes.

Red X mark. Unsupported feature. No.

Green checkmark. Supported feature. Yes.

Green checkmark. Supported feature. Yes.

Green checkmark. Supported feature. Yes.

Estimated Rates

Green checkmark. Supported feature. Yes.

Green checkmark. Supported feature. Yes.

Green checkmark. Supported feature. Yes.

Green checkmark. Supported feature. Yes.

Green checkmark. Supported feature. Yes.

Carrier Insurance

Green checkmark. Supported feature. Yes.

Green checkmark. Supported feature. Yes.

Green checkmark. Supported feature. Yes.

Green checkmark. Supported feature. Yes.

Green checkmark. Supported feature. Yes.

Tracking

Green checkmark. Supported feature. Yes.

Green checkmark. Supported feature. Yes.

Green checkmark. Supported feature. Yes.

Green checkmark. Supported feature. Yes.

Green checkmark. Supported feature. Yes.

End of Day (Electronic)

Grey dash icon. Not applicable.

Red X mark. Unsupported feature. No.

Green checkmark. Supported feature. Yes.

Green checkmark. Supported feature. Yes.

Red X mark. Unsupported feature. No.

End of Day (PDF)

Grey dash icon. Not applicable.

Red X mark. Unsupported feature. No.

Green checkmark. Supported feature. Yes.

Red X mark. Unsupported feature. No.

Red X mark. Unsupported feature. No.

Label Branding

Red X mark. Unsupported feature. No.

Red X mark. Unsupported feature. No.

Green checkmark. Supported feature. Yes.

Green checkmark. Supported feature. Yes.

Red X mark. Unsupported feature. No.

Label Messages

Green checkmark. Supported feature. Yes.

Red X mark. Unsupported feature. No.

Green checkmark. Supported feature. Yes.

Green checkmark. Supported feature. Yes.

Green checkmark. Supported feature. Yes.

Multi-package Shipping

Red X mark. Unsupported feature. No.

Red X mark. Unsupported feature. No.

Red X mark. Unsupported feature. No.

Green checkmark. Supported feature. Yes.

Red X mark. Unsupported feature. No.

Third-Party Billing

Red X mark. Unsupported feature. No.

Red X mark. Unsupported feature. No.

Red X mark. Unsupported feature. No.

Red X mark. Unsupported feature. No.

Red X mark. Unsupported feature. No.

The carrier can be used to create domestic shipping labels.

The carrier can be used to create international shipping labels.

ShipStation API will submit international customs declarations electronically to the carrier.

The carrier can be used to create domestic return labels.

When an API call is made to the Rates endpoint, ShipEngine will return estimated shipping rates for the carrier based on the connected account information and shipment details.

Shipment insurance, provided by the shipment's selected carrier, can be added to the shipment in ShipStation API. This insurance would be in addition to any default coverage already provided by that carrier.

Shipping labels created for this carrier will include a tracking number that can be used to view the shipment status on the carrier's tracking website. Tracking may not be available for all shipping services.

Shipment manifests and End of Day documents are submitted electronically to the carrier by ShipEngine.

Shipment manifests and End of Day documents are generated as PDF files that can be printed along with shipping labels. Because these documents are not electronically submitted, physical copies must be provided to the carrier.

ShipEngine can print your brand logo on shipping labels from carriers that support this feature. Add your logo in the ShipEngine Dashboard.

ShipEngine can include additional information on a shipping label that is specified in the label request, if supported by the carrier.

This carrier can be used to create multi-package shipments, where multiple labels are created for a single shipment and the individual packages are linked together in a single shipment record with a master tracking number.

The carrier can be used to create domestic shipping labels.

The carrier can be used to create international shipping labels.

ShipStation API will submit international customs declarations electronically to the carrier.

The carrier can be used to create domestic return labels.

When an API call is made to the Rates endpoint, ShipEngine will return estimated shipping rates for the carrier based on the connected account information and shipment details.

Shipment insurance, provided by the shipment's selected carrier, can be added to the shipment in ShipStation API. This insurance would be in addition to any default coverage already provided by that carrier.

Shipping labels created for this carrier will include a tracking number that can be used to view the shipment status on the carrier's tracking website. Tracking may not be available for all shipping services.

Shipment manifests and End of Day documents are submitted electronically to the carrier by ShipEngine.

Shipment manifests and End of Day documents are generated as PDF files that can be printed along with shipping labels. Because these documents are not electronically submitted, physical copies must be provided to the carrier.

ShipEngine can print your brand logo on shipping labels from carriers that support this feature. Add your logo in the ShipEngine Dashboard.

ShipEngine can include additional information on a shipping label that is specified in the label request, if supported by the carrier.

This carrier can be used to create multi-package shipments, where multiple labels are created for a single shipment and the individual packages are linked together in a single shipment record with a master tracking number.

Scheduling a Pickup? Carriers may charge a pickup fee!

Some carriers charge a fee for scheduled pickups depending on the type and frequency. Be sure to check with your carrier to ensure you don't incur any unexpected charges.

Available Services

Click to view the available services for DHL Express, USPS, UPS, and FedEx from ShipStation API.

FedEx from ShipStation API Services

FedEx - Active Service Disruptions: Middle East Service Update

We continue to evaluate the situation in the Middle East. FedEx has resumed pickup and delivery services across the Middle East, where it is safe to do so and in line with local guidance.  Customers shipping to or from the region may experience extended transit times.

The safety and security of our team members is our top priority, alongside our commitment to providing the best possible service for our customers. We are closely monitoring the situation and operating according to guidance from local authorities.

For the latest shipment status information, track your shipment at fedex.com. Please continue to check this page for updates.

Consistent with the provisions of the FedEx Service Guide, affected shipments are not eligible for a refund or credit under the Money-Back Guarantee policy.

Last updated March 4, 2026.

Russia and Belarus Service Suspension

All Russian and Belarusian FedEx International services continue to be suspended until further notice. 

Initially reported February 24, 2022; Last confirmed January 26, 2026.

🇺🇸 US Services & Package Types

FedEx Domestic Services

Shipping Service

Carrier Code

API Code

FedEx Ground®

FEDEX_GROUND

fedex_ground

FedEx Economy

FEDEX_EXPRESS_SAVER

fedex_economy

FedEx 2Day®

FEDEX_2_DAY

fedex_2day

FedEx 2Day® One Rate

FEDEX_2_DAY_ONE_RATE

fedex_2day_one_rate

FedEx Standard Overnight®

STANDARD_OVERNIGHT

fedex_standard_overnight

FedEx Priority Overnight®

PRIORITY_OVERNIGHT

fedex_priority_overnight

FedEx Home Delivery®

GROUND_HOME_DELIVERY

fedex_home_delivery

FedEx Express Saver® One Rate

FEDEX_EXPRESS_SAVER_ONE_RATE

fedex_economy_one_rate

FedEx Standard Overnight® One Rate

STANDARD_OVERNIGHT_ONE_RATE

fedex_standard_overnight_one_rate

FedEx Priority Overnight® One Rate

PRIORITY_OVERNIGHT_ONE_RATE

fedex_priority_overnight_one_rate

FedEx Ground® Economy Parcel Select

SMART_POST-PARCEL_SELECT

fedex_ground_economy_parcel_select

UPS Service Alert: Middle East Service Impact

UPS is closely monitoring the situation in the Middle East and using established contingency plans to manage our operations safely and efficiently.

Our focus is on safety while we work to minimize impacts for our customers.

For the most up-to-date information on the status of shipments, customers can track a package on ups.com.

Note that the UPS Service Guarantee does not apply to shipments affected.

FedEx International Services

Shipping Service

Carrier Code

API Code

FedEx International Economy®

INTERNATIONAL_ECONOMY

fedex_international_economy

FedEx International Priority®

FEDEX_INTERNATIONAL_PRIORITY

fedex_international_priority

FedEx International Priority® Express

FEDEX_INTERNATIONAL_PRIORITY_EXPRESS

fedex_international_priority_express

FedEx International Connect Plus®

FEDEX_INTERNATIONAL_CONNECT_PLUS

fedex_international_connect_plus

Packaging Types

Name

Carrier Packaging Code

API Code

FedEx® Box

FEDEX_BOX

fedex_box

FedEx® Envelope

FEDEX_ENVELOPE

fedex_envelope

FedEx® Pak

FEDEX_PAK

fedex_pak

FedEx® Tube

FEDEX_TUBE

fedex_tube

FedEx® 10kg

FEDEX_10KG_BOX

fedex_10kg_box

FedEx® 25kg

FEDEX_25KG_BOX

fedex_25kg_box

FedEx® Small Box

FEDEX_SMALL_BOX

fedex_small_box

FedEx® Medium Box

FEDEX_MEDIUM_BOX

fedex_medium_box

FedEx® Large Box

FEDEX_LARGE_BOX

fedex_large_box

FedEx® Extra Large Box

FEDEX_EXTRA_LARGE_BOX

fedex_extra_large_box

Package

YOUR_PACKAGING

package

🇨🇦 FedEx from ShipStation API Canada Services & Package Types

FedEx Domestic Services

Shipping Service

Carrier Code

API Code

FedEx Ground®

FEDEX_GROUND

fedex_ground

FedEx Economy

FEDEX_EXPRESS_SAVER

fedex_economy

FedEx 2Day®

FEDEX_2_DAY

fedex_2day

FedEx Standard Overnight®

STANDARD_OVERNIGHT

fedex_standard_overnight

FedEx Priority Overnight®

PRIORITY_OVERNIGHT

fedex_priority_overnight

FedEx First Overnight®

FIRST_OVERNIGHT

fedex_first_overnight

UPS Service Alert: Middle East Service Impact

UPS is closely monitoring the situation in the Middle East and using established contingency plans to manage our operations safely and efficiently.

Our focus is on safety while we work to minimize impacts for our customers.

For the most up-to-date information on the status of shipments, customers can track a package on ups.com.

Note that the UPS Service Guarantee does not apply to shipments affected.

FedEx International Services

Shipping Service

Carrier Code

API Code

FedEx International Economy®

INTERNATIONAL_ECONOMY

fedex_international_economy

FedEx International Ground®

FEDEX_GROUND

fedex_ground_international

FedEx International First®

INTERNATIONAL_FIRST

fedex_international_first

FedEx International Priority®

FEDEX_INTERNATIONAL_PRIORITY

fedex_international_priority

FedEx International Priority® Express

FEDEX_INTERNATIONAL_PRIORITY_EXPRESS

fedex_international_priority_express

FedEx International Connect Plus®

FEDEX_INTERNATIONAL_CONNECT_PLUS

fedex_international_connect_plus

FedEx Package Types

Name

Carrier Packaging Code

API Code

FedEx® Box

FEDEX_BOX

fedex_box

FedEx® Envelope

FEDEX_ENVELOPE

fedex_envelope

FedEx® Pak

FEDEX_PAK

fedex_pak

FedEx® Tube

FEDEX_TUBE

fedex_tube

FedEx® 10kg

FEDEX_10KG_BOX

fedex_10kg_box

FedEx® 25kg

FEDEX_25KG_BOX

fedex_25kg_box

FedEx® Small Box

FEDEX_SMALL_BOX

fedex_small_box

FedEx® Medium Box

FEDEX_MEDIUM_BOX

fedex_medium_box

FedEx® Large Box

FEDEX_LARGE_BOX

fedex_large_box

FedEx® Extra Large Box

FEDEX_EXTRA_LARGE_BOX

fedex_extra_large_box

Package

YOUR_PACKAGING

package

  File a Claim for FedEx from ShipStation API - US and Canada Only

  For merchants with US or Canada-based accounts, ShipStation API manages all loss or damage claims for shipments sent with FedEx from ShipStation API. Claims and coverage are not available for FedEx from ShipStation accounts outside of the US or Canada.

Claims over $100 USD or CAD not Eligible

If you need to file a claim for a shipment with a declared value over $100 or if your account is outside of the US or Canada, you must reach out to your insurance provider.

Claim Requirements

  • All claims for domestic shipments must be submitted within 60 days of the shipment date.

  • All claims for international shipments must be submitted within 21 days of the shipment date.

  • For damage claims, include photos of the damaged packaging and contents.

File Claim

To file a claim for lost or damaged FedEx from ShipStation shipments:

  1. Click this link to access the claim form: FedEx from ShipStation Claim Form.

  2. Fill in all the required fields and submit the form when complete.

File a Claim for FedEx Ground Economy

To file a claim for FedEx Ground Economy shipments, follow these steps:

  1. Download and complete the FedEx Ground Economy Claim Form (attached at the bottom of this article).

  2. Email the completed form to support@shipstation.com.

  3. Enter the following email subject line: FedEx Ground Economy Claim – [Shipment Tracking Number].

    Note: This helps route your claim to the correct support team more quickly.

What Happens After You File a Claim

  • Once the claim has been processed, payment is applied to your account within 45 days.

  • For FedEx Ground Economy, claims can take up to 2 weeks to process or up to 6 weeks.

Reroute or Redirect a FedEx from ShipStation Shipment

A FedEx from ShipStation API shipment can be returned to the sender. To reroute or redirect an in-transit shipment, go to the FedEx from ShipStation form and follow the provided instructions.

Select the option to Reroute my FedEx from ShipStation API package and complete the required information.

Reroute Fee

FedEx may charge a fee for rerouting shipments. By submitting your request, you agree to any carrier-assessed charges. Any fees incurred will be deducted from your ShipStation API balance.

A few things to keep in mind when rerouting a package:

  • Shipments out for delivery may not be eligible for delivery intercept.

  • Eligibility is determined by the carrier.

  • This is not a guaranteed service, so It is important to file this claim as soon as possible.

Notes about FedEx from ShipStation API

  • Pickup/Dropoff (PUDO) is not supported with FedEx from ShipStation.

  •  Pickups: FedEx from ShipStation API supports pickups in the UK only. Pickups are not supported outside of the UK.

  • DDP: FedEx from ShipStation API does not support DDP. FedEx supports DDP with direct integrations only.

  • Do Not Overstuff Boxes: All items must fit in a FedEx One Rate box so it seals neatly and without changing the box’s shape or dimensions. Please use a larger box if the items do not fit. 

    Any overstuffed box will incur adjustment charges.

  • Ordering Supplies is not supported through FedEx from ShipStation API

  • Fuel Charge Discrepancies: For most services, FedEx includes a fuel charge as part of the label cost. FedEx updates this cost weekly, depending on the fuel prices at the time of label purchase. Occasionally, there are discrepancies between the calculated fuel-price rate and what FedEx charged at the time of label purchase.

    If the fuel-charge amount differs from what was charged to the merchant, ShipStation will adjust the amount (charged or refunded) for the merchant when we receive the FedEx invoice.

    To avoid fuel charge discrepancies, please consider using a FedEx service that does not apply a fuel charge:

    • All FedEx One Rate services

    • FedEx International Connect Plus

  •  For Canada-based accounts, FedEx from ShipStation does not support Money Back Guarantee (MBG) for shipping services.

  • ShipStation does not charge taxes for shipments using FedEx from ShipStation.

  • FedEx from ShipStation API does not support third-party billing.

  • Adjustments for Package and Weight Dimensions: During shipping, overhead scanners and scales automatically verify package dimensions and weight. If there are differences from the initial information provided, adjustment charges may occur.

    For size discrepancies, carriers typically require a drop-off receipt or significant evidence to consider dispute claims. Adjustment dispute resolutions are ultimately decided by the carrier. Review individual carrier terms of service for additional details.

    • Adjustment requests for Express shipments (domestic and international) must be submitted within 50 days,

    • Adjustment requests for Ground shipments must be submitted within 160 days.

  •  Maximum Weight per package: 68 kg (ultimate re-rate weight acceptable is 70.5kg)

  •  Maximum Dimensions per package (Length, Width, Height): 121 cm for each dimension (ultimate maximum via adjustment is 274 cm)

  •  Maximum Girth + Length per package: 330 cm (Length and Girth Combined: Width + (2*Height) + Length)

  • EIN required for US shipments over $2,500: For US shipments exceeding a value of $2,500, a valid Employer Identification Number (EIN) must be provided in the Recipient Tax Information. Not providing this value may result in the shipment not being processed correctly.

  • Duties and Taxes Adjustment: DDP (billing duties and taxes to the payor of the shipping charges) is not supported.

  • Restricted Items: FedEx from ShipStation does not support shipping alcohol, dry ice, tobacco, firearms, live animals, dangerous goods, or other items or commodities that may be prohibited by the FedEx Service Guide or by law. Such commodities require a separate agreement.

  • Liquids, Aerosols, and Gels (LAGs) Restrictions: Shipments will be rejected and returned to the shipper if LAGs are packed with electrical/electronic devices or if the contents do not match the item declaration on the Air Waybill.

  • COD (Collect on Delivery) and scheduling pickups are not available.

  • Electronic Trade Documents (ETD): For the countries listed here, customs data are passed to FedEx electronically and there is no need to print the customs forms.

    For countries not listed, please print the customs documentation (returned with the call for API users) and attach it to the shipment.

    *ShipStation will not support ETD for all countries where FedEx supports ETD. We can only support it with countries that do not require a letterhead.

    • Austria, Australia, Belgium, Bahrain, Canada, Switzerland, Côte d'Ivoire (Ivory Coast), Germany, Denmark, Finland, Micronesia, Federated States of France, United Kingdom, Croatia, Ireland, Japan, Liechtenstein, Sri Lanka, Luxembourg, Monaco, Marshall Islands, Macau, Northern Mariana Islands, Mexico, Netherlands (Holland), Poland, Puerto Rico, Palestinian Territory, Occupied Palau, Saudi Arabia, Sweden, Slovenia, Slovak Republic (Slovakia), San Marino, Togo, Tunisia, Holy See (Vatican City State).

  • Error Message: Alert on FedEx Tracking Page - “Clearance instructions from the importer are required.“

    • This can occur if certain customs information (like the EORI or HS codes) is not included when the shipment is processed. In this situation, the shipment is held up at customs due to the missing information. Contact support if you see this error.

DHL Express from ShipStation API Services

DHL: Optimizing Customs Data for International Shipments to Prevent Delays

To ensure smooth customs clearance and minimize the risk of shipment inspections or delays, it is critical to provide high-quality data for every international shipment. Poor data quality, specifically vague descriptions and missing HS codes, often triggers manual reviews by destination authorities.

Key Takeaways for Merchants

  • Be Literal: Describe the item as if you are explaining it to someone who cannot see it.

  • Include Part Numbers: If your product has a Part Number (PAN), include it in the reference field to help customs verify the item.

  • The "Rule of Three": A great description usually answers What it is, What it's made of, and What it's for.

Write Accurate Line Item Descriptions

Customs authorities need to know exactly what is being imported, what it is made of, and its intended use. Avoid using internal marketing descriptions or vague terms.

  • Avoid Stop Words: Words like "Sample," "Variety," or "Gift" are frequently flagged and may trigger an automatic inspection. For a List of Common Stop Words, see the PDF attachment at the end of this article.

  • Include Material Composition: For items like footwear or apparel, specify the materials (e.g., "Men’s jeans, 80% cotton, 20% polyester" instead of just "Jeans").

  • Detail the Product Type: Instead of "VINTAGE FOOTWEAR," use "Women’s shoes - leather upper and rubber sole."

  • Be Specific: Instead of "Wheel adjusted," use "Bicycle rear pivot part."

Utilizing Harmonized System (HS) Codes

Providing a correct HS code (or Commodity Code) is the most effective way to help customs officials categorize your goods.

  • 🇺🇸 US-Based Shippers: Use the US Census Bureau’s Schedule B Search Engine to find the correct code.

  • Global Shippers: Ensure you are using the most current codes required by the destination country to avoid incorrect duty/tax calculations.

Provide Part and Reference Numbers

When possible, include the specific part or item number in your commercial invoice data. Mapping these to the correct reference fields in your shipping tool (e.g., the "PAN" reference type) provides an extra layer of clarity for clearance agents and helps verify the item against the provided description.

Prohibited Stop Words & Description Comparison

Using vague language is the fastest way to get a shipment flagged for inspection. Below are examples of poor descriptions found in recent audit data versus the clear, detailed descriptions required by customs authorities. For a List of Common Stop Words, see the PDF attachment at the end of this article.

Poor Description (Vague)

Better Description (Detailed)

Why it Matters

VINTAGE FOOTWEAR

Women's shoes: leather upper, rubber sole

Defines gender, material, and sole type.

JEANS

Men’s jeans: 80% cotton, 20% polyester

Specifies material composition for textiles.

SAMPLE / VARIETY

Stainless steel kitchen whisk (K792)

Stop Words like "Sample" or "Variety" trigger automatic flags.

HAIR PRODUCT

Organic argan oil hair serum (100ml)

Identifies the specific substance and volume.

The Mesa - Medium

Canvas messenger bag with brass buckles

Moves past marketing names to actual physical traits.

Merchant Checklist: International Shipping Compliance

To ensure your international shipments clear customs without delay, use this checklist to review your data before printing your labels.

  • [ ] Is the description specific? (e.g., "Men's 100% cotton t-shirt" instead of "Apparel")

  • [ ] Did you avoid Stop Words? (Ensure "Sample," "Gift," and "Variety" are not used)

  • [ ] Is the material composition listed? (e.g., "Stainless steel," "Leather," "Plastic")

  • [ ] Is the HS code/Commodity code included? (Use a search tool if you aren't 100% sure)

  • [ ] Is the Part Number (PAN) mapped correctly? (Helps verify the item in the clearance system)

  • [ ] Is the unit value and currency accurate? (Ensure values match your commercial invoice)

Description Logic: The "Physical" Rule

When writing descriptions, ignore your marketing names. Customs authorities don't know what a Polaris IGX 144+ Linkage Kit is. Instead, describe the physical object: Steel mechanical linkage parts for vehicle suspension.

Technical Note: Mapping Compliance Data

When integrating with international carriers, how you map data fields in your API payload directly impacts customs clearance rates. While the UI may show a single "Description" field, the backend mapping should prioritize the following:

  1. Reference Field Mapping (PAN)

    To assist customs authorities in verifying shipments against digital records, ensure that product part numbers are mapped to the correct reference type.

    • Reference Type: PAN (Part Number)

    • Usage: Map your internal SKU or manufacturer part number here. This allows clearance systems to match the physical item to the digital declaration more efficiently.

  2. Data Integrity vs. UX Display

    It is important to note that what the customer sees in the ShipStation or Shopify UI may not always reflect the full data payload sent to the carrier.

    • Payload Enrichment: Even if a merchant uses a short marketing title in their store, the integration should attempt to send the most granular description available in the product database to the description field in the customs object.

    • Stop Word Scrubbing: Consider implementing a validation layer that flags or prevents the use of Stop Words (Sample, Gift, Variety) in the description field before the API call is finalized.

  3. HS Code Automation

    Automating the harmonized_tariff_code field is the highest-value optimization you can provide. Ensuring this field is populated with a 6 to 10-digit code reduces the reliance on the text description alone, as the code provides a universal language for customs agents worldwide.

USPS from ShipStation API Services

USPS Service Details

The following table provides further details about USPS Services:

Service

Description

Supports Dangerous Goods advanced option for USPS Ground Advantage

If your shipment contains dangerous goods, be sure to include the Dangerous Goods advanced option in your Create Label call.

Currently, shipments containing dangerous goods can only be shipped using USPS Ground Advantage as a service with ShipEngine.

This carrier may have other requirements when shipping dangerous goods. Check with your account representative to understand what qualifies as dangerous goods and any requirements your carrier may have for these shipments.

Cubic Pricing with USPS from ShipStation API

Cubic pricing is available by default for all USPS from ShipStation API shipments.

Cubic rates are ideal for small, heavy packages since the pricing is based on the volume of the package instead of the weight.

To receive cubic rates in ShipStation API:

  1. Choose USPS Ground Advantage (formerly Parcel Select Ground) or a domestic Priority service.

  2. Choose a package type of Package.

  3. Enter the package weight & dimensions.

ShipStation API will automatically apply the cubic rate whenever it's cheaper than the Priority rate.

UPS from ShipStation API Services

UPS Service Alert: Middle East Service Impact

UPS is closely monitoring the situation in the Middle East and using established contingency plans to manage our operations safely and efficiently.

Our focus is on safety while we work to minimize impacts for our customers.

For the most up-to-date information on the status of shipments, customers can track a package on ups.com.

Note that the UPS Service Guarantee does not apply to shipments affected.

 UPS® Ground Saver

UPS® Ground Saver is an economy, commercial or residential, ground delivery service available for accounts shipping from the US. It is designed for lightweight, non-time-sensitive packages. UPS® Ground Saver offers a clear savings advantage to help you manage shipping costs and offer your customers a positive delivery experience.

Accept the new Terms & Conditions for UPS from ShipStation API to make this service available in your account if it isn't already.

UPS Ground Saver® Updates

  • UPS® Ground Saver packages MUST be dropped off with UPS, even if the USPS might make the final package delivery.

  • DO NOT drop off UPS Ground Saver packages with the USPS. The USPS may deny delivery of packages and claim that postage was not paid for.

  • Additionally, as of April 2, 2025, UPS has reduced Ground Saver's free Declared Value Coverage from $100 to $20. To make up the difference, you can purchase ParcelGuard on ShipStation API starting at $0.99 per $100 of insured value.

UPS Ground Saver Features

  • Delivers Monday - Sunday

  • No surcharges for residential delivery

  • Door-to-Door tracking

  • Competitive delivery times (estimates appear in ShipStation API when configuring shipments)

  • UPS® Ground Saver shipments move through the UPS network and will be delivered by UPS or, in some cases, will be handed off to the local Post Office for final delivery by the USPS.

  • Ship to PO Boxes, military addresses, and US territories (since USPS can handle last-mile delivery).

Shipping Requirements

  • Weight: Packages up to 70 lbs actual weight or up to 10lbs

  • Size limitations:

    • Packages must be at least 4" high, 6" long, and 0.75" wide

    • Combined length + girth dimensions cannot exceed 130 inches; no one dimension can exceed 60 inches

  • Domestic Shipments to the 48 contiguous States

Shipping Considerations

  • UPS Ground Saver service can only be used within the US. It is not available to shippers in other countries.

  • UPS® Ground Saver shipments are not eligible for signature confirmation or UPS Guaranteed Service Refunds.

  • Shipments cannot be rerouted.

  • Surcharges may apply.

    • Non-Standard Cube Charge: Any package with L x W x H measuring more than 3456 cubic inches)

    • Non-Standard Length Charge: Any package where the longest side measures more than 22 inches while not exceeding 30 inches

    • Non-Standard Extra Length Charge: Any package where the longest side measures more than 30 inches while not exceeding 48 inches

  • UPS may inspect the package. If damaged, they will not send it, but will instead return it to the sender.

UPS reserves the right to update service details and restrictions at any time.

GlobalPost from ShipStation API

GlobalPost Domestic Services

  • GlobalPost Edge

GlobalPost International Services

  • GlobalPost Plus Intl

  • GlobalPost Economy Intl

  • GlobalPost Standard Intl

  • GlobalPost International Standard Returns

  • GlobalPost Go

GlobalPost Package Types

  • Package

GlobalPost Confirmation Options

  • No Signature

GlobalPost from ShipStation API

GlobalPost is a modern, economical way to ship internationally from the US, Canada, and the UK to more than 220 countries*. For accounts based in these countries, you automatically have access to GlobalPost from ShipStation API services once you’ve set up your ShipEngine Carriers payment method.

When shipping with GlobalPost, you can enjoy the following benefits:

  • Some of the most competitive rates for international shipping (visit the GlobalPost List Pricing page for rate details)

  • Electronic customs forms submission - you no longer have to worry about printing customs forms!

  • Automatic Harmonized System Codes - as long as your item descriptions are accurate, GlobalPost will add the proper HS Codes to your customs forms!

  • No minimum volume requirements

  • No hidden surcharges

  • Default loss and damage coverage (varies by country and service)

  • Dedicated GlobalPost tracking

*GlobalPost does NOT ship to the following countries: Cuba, Iran, North Korea, Syria, Sudan, Russia

🇺🇸 Shipping GlobalPost with a Stamps.com Account

This article is about using GlobalPost from ShipStation API, a carrier included with ShipStation API carrier services.

For details about using GlobalPost services with your Stamps.com account please read our Ship Internationally with GlobalPost help article.

GlobalPost from ShipStation API Requirements
  • A ShipStation API account based in the US, Canada, or the UK

  • Activate ShipEngine Carriers by adding your payment method.

    You'll be prompted to enter your payment method the first time you attempt to create a label with any ShipStation API Carrier, or you can add in advance in either your Carrier settings or Payments & Subscription settings.

  • Add Funds to your ShipStation API Balance.

    All ShipStation API Carrier labels are purchased using the funds in your ShipStation API Balance. The first time you add your payment method, you'll be prompted to add funds so you can begin purchasing labels right away.

  • Submit your information to GlobalPost via this form to get approval. GlobalPost will then contact you to verify your account. This process can take 2-3 business days.

Additional Surcharge adjustments may apply, even with accurate Weights & Dimensions.

Charges for additional handling and Adjustment Processing Fees may apply due to the packaging type or other concerns. See our ShipStation Carrier Adjustments page for details.

GlobalPost Shipping Tools

GlobalPost also provides some useful tools to assist in your international shipping: The HS Classification Tool (or Harmonization Code Lookup) and the Duties & Taxes Calculator.

HS Code Lookup Tool

The Harmonization Code Lookup tool helps you find the appropriate harmonization codes for your customs declarations. We recommend always including the correct harmonization codes on your customs declarations to ensure the destination country's customs authority can process your shipment in the quickest way possible.

To use the lookup tool, enter a simple item description in the search field and click Find Code. You'll then be prompted to drill down on the details of your item with a series of multiple-choice questions until the right code has been identified.

GlobalPost HS code lookup page with "Shirts" entered into search field and "Construction" options available for selection

You can then enter the code into the Harmonization Code field for the shipment in ShipStation API.

Duties & Taxes Calculator

The GlobalPost Duties & Taxes Calculator can help you estimate how much duty and taxes can be expected when you ship certain types of goods (based on your HS code) to certain countries. Know in advance how much duty and taxes will apply to a shipment so you can budget or charge your customers appropriately.

The GlobalPost Duties and Taxes Calculator screen

Common Post-Shipping Adjustments by Carrier

See the Common Adjustments by Carrier section of the ShipStation API ShipStation Carrier Adjustments page for carrier-specific, post-shipping adjustments.

File a Claim for Loss or Damage

Should any of your GlobalPost shipments that include loss/damage coverage become lost or damaged in transit, you can file a claim within 90 days of the shipment date.

GlobalPost Claim limits vary by country:

  • 🇺🇸 US-based accounts include up to $100 in loss/damage protection for Standard shipments and up to $200 in loss/damage protection for Plus shipments.

  • 🇬🇧 UK-based accounts include up to £50 in loss/damage protection for Standard shipments plus the cost of the label.

Requirements for Filing a Claim

  • All claims must be filed by the shipper, not the recipient.

  • Damage claims can be submitted at any time. Claims for lost packages cannot be submitted until 30 days after the shipment date.

  • All claims must be submitted within 90 days after the shipment date.

How to File a Claim

  1. Go to the GlobalPost Claim Form page.

  2. Fill in the online form:

    • You will need a good contact email, the shipment tracking number, the shipment date, and the claim amount.

    • Do not include the shipping cost when filling in the Claim Amount field. If the claim is approved, the shipping cost will be added to your total payment.

    • For damage claims, upload an image of the damaged shipment.

  3. Send the form when all fields have been completed.

    • If you submit a partially completed form, GlobalPost will not be able to process your claim and will notify you via email. Complete any missing information on your previously submitted claim form and resubmit it, or complete a new claim.

Once a claim has been approved, the refund will be credited to your shipping account within 3 business days. It can take up to 3 weeks for a claim to be processed. Please contact GlobalPost if you have not received a response to your claim within 3 weeks.

If you feel your claim was incorrectly denied, please submit a new claim with new or updated information.

Notes about Shipping with GlobalPost
  • When configuring your GlobalPost shipments, we recommend always including the package dimensions for the shipment, in addition to the weight. GlobalPost uses dimensional weight, so even though dimensions are not required for you to create a label, adding the package dimensions will ensure you receive the most accurate rate.

    Because GlobalPost uses dimensional weight, in most cases where dimensions are not included for the shipment, you will receive a post-shipment adjustment back to your account for the difference in the rate paid versus the actual rate.

  • There are two tracking numbers associated with a GlobalPost shipment:

    1. The GlobalPost tracking number.

      ShipStation API sends this tracking number to your customer and selling channel during the marketplace notification processes.

      For Economy shipments, packages are tracked only to the destination country. For Standard and Smartsaver shipments, packages are tracked to the destination address.

    2. The tracking number on the actual label generated in ShipStation API.

      This tracking number can only be used to track the movement from the shipment's origin location to the GlobalPost sorting facility. It is not shared with your customer or selling channel.

  • You will not print customs forms in ShipStation API.

    ShipStation API will submit the customs information electronically, and GlobalPost will include the necessary customs documents when the package is relabeled at their sorting facility. Additionally, if your item descriptions in ShipStation API are accurate, GlobalPost will automatically add the correct HS Codes to your customs forms for all EU-bound shipments.

  • Additional carrier insurance is not available for GlobalPost shipments. However, you can add ShipStation API's partner insurance to GlobalPost shipments.

  • Currently, GlobalPost labels do not support Unicode characters (for example, Kanji or Cyrillic).

  • Label Messages for SmartSaver supports three reference fields, all other services only support the first two reference fields. Up to 24 characters can be used per field.

Troubleshooting Tips for the GlobalPost Integration

Here are some common issues, potential causes, and troubleshooting tips.

Issue

How to Troubleshoot or Resolve

Error Message:  (211000012) This shipper is not allowed to process GlobalPost shipments. (Generic). (400)

What it Means: You're not yet fully connected to GlobalPost.

What to Do: You need to submit information to GlobalPost to get secondary approval from them. GlobalPost will then contact you to clear your account. This can take 2-3 business days.

The carrier can be used to create domestic shipping labels.

The carrier can be used to create international shipping labels.

ShipStation API will submit international customs declarations electronically to the carrier.

The carrier can be used to create domestic return labels.

When an API call is made to the Rates endpoint, ShipEngine will return estimated shipping rates for the carrier based on the connected account information and shipment details.

Shipment insurance, provided by the shipment's selected carrier, can be added to the shipment in ShipStation API. This insurance would be in addition to any default coverage already provided by that carrier.

Shipping labels created for this carrier will include a tracking number that can be used to view the shipment status on the carrier's tracking website. Tracking may not be available for all shipping services.

Shipment manifests and End of Day documents are submitted electronically to the carrier by ShipEngine.

Shipment manifests and End of Day documents are generated as PDF files that can be printed along with shipping labels. Because these documents are not electronically submitted, physical copies must be provided to the carrier.

ShipEngine can print your brand logo on shipping labels from carriers that support this feature. Add your logo in the ShipEngine Dashboard.

ShipEngine can include additional information on a shipping label that is specified in the label request, if supported by the carrier.

This carrier can be used to create multi-package shipments, where multiple labels are created for a single shipment and the individual packages are linked together in a single shipment record with a master tracking number.