Site Logo

🎉 ShipEngine is becoming ShipStation API 🎉

Over the next few months you'll notice the ShipEngine website, documentation portal, and dashboard being rebranded as ShipStation API. For our ShipEngine customers, you don't need to take any action or change any of your integrations in any way. All endpoints will remain the same and continue to function as they always have.

To learn more about what's coming, review our New ShipStation API page.

FedEx from ShipStation

FedEx from ShipStation offers both domestic and international services for accounts shipping from the US.

This guide provides developers with the details needed to build FedEx from ShipStation shipping capabilities into your ShipStation API workflows.

ShipStation API also allows you to connect your own existing FedEx account, and the requirements and service details are different than those for FedEx from ShipStation. For details about connecting and using your own FedEx account with ShipStation API, see our FedEx or FedEx UK guides.

Requirements

carrier_name: fedex_walleted

  • A ShipStation API account based in the United States.
  • ShipStation Carriers must be activated for the account and have a positive account balance to create labels. See our Using ShipStation Carriers page for details about activating it in your account.
  • A weight value is required for all shipments.

Rates

FedEx from ShipStation supports rate shopping with ShipStation API.

Service Details

Services available with FedEx from ShipStation appear in this table. Please note that carriers may update their available services at any time. To ensure you are always using valid services, you can use the list carrier services endpoint at any time.

Domestic Services

ServiceAPI Code
FedEx Ground®fedex_ground
FedEx Economyfedex_economy
FedEx 2Day®fedex_2day
FedEx Standard Overnight®fedex_standard_overnight
FedEx Priority Overnight®fedex_priority_overnight
FedEx Home Delivery®fedex_home_delivery
FedEx 2Day® One Ratefedex_2day_one_rate
FedEx Express Saver® One Ratefedex_economy_one_rate
FedEx Standard Overnight® One Ratefedex_standard_overnight_one_rate
FedEx Priority Overnight® One Ratefedex_priority_overnight_one_rate
FedEx Ground® Economy Parcel Selectfedex_ground_economy_parcel_select

International Services

ServiceAPI Code
FedEx International Economy®fedex_international_economy
FedEx International Priority®fedex_international_priority
FedEx International Priority® Expressfedex_international_priority_express
FedEx International Connect Plus®fedex_international_connect_plus

Return Services

FedEx from ShipStation supports creating return labels with any domestic service.

Review the Return Shipping Labels page for details on creating return labels with ShipStation API.

Packages

The following carrier package types are available for FedEx from ShipStation services:

NameAPI CodePackage Attributes
FedEx® Boxfedex_boxInternational, Domestic
FedEx® Envelopefedex_envelopeInternational, Domestic
FedEx® Pakfedex_pakInternational, Domestic
FedEx® Tubefedex_tubeInternational, Domestic
FedEx® 10kg Boxfedex_10kg_boxInternational
FedEx® 25kg Boxfedex_25kg_boxInternational
FedEx® Small Boxfedex_small_boxDomestic
FedEx® Medium Boxfedex_medium_boxDomestic
FedEx® Large Boxfedex_large_boxDomestic
FedEx® Extra Large Boxfedex_extra_large_boxDomestic

You can also use the generic package type or custom package types.

One Rate Packaging

One Rate services will automatically select the best package type based on dimensions. If FedEx-specific packaging has not been selected for a One Rate service, the package type will be automatically selected based on dimensions for both rate calculation and label creation. The FedEx-specific package is needed to properly calculate the rate for the One Rate services, but you can still use your own box or packaging if it meets the restrictions on dimensions.

Adding Shipment Insurance

FedEx from ShipStation does not support adding carrier insurance to shipments created with ShipStation API. However, FedEx does include coverage up to $100 for all services, including Ground Economy.

For US-based accounts, if you need to add more coverage to a shipment, you can do so using ParcelGuard. Review the Parcel Insurance page for details on adding shipment insurance with ShipStation API.

Label Support

  • Label sizes: 4" x 6", 4" x 8"
  • Label formats: PDF, PNG, ZPL

Label Reference Fields

FedEx from ShipStation supports adding custom label messages.

  • The merchant SID is automatically mapped to reference field 1.
  • You can add custom messages to reference fields 2 and 3.

Multi-Package Labels

FedEx from ShipStation does not support creating multi-package shipments.

Label Branding

FedEx from ShipStation does not support label branding.

Voiding Labels

FedEx from ShipStation supports voiding labels with ShipStation API. This voids the label in the ShipStation API system and any label funds will be returned to your account balance immediately.

See our Void a Label page for details about voiding labels with ShipStation API.

Paperless Labels

FedEx from ShipStation does not support paperless labels.

Customs Declarations

For most countries, customs declarations are submitted electronically to FedEx (via ETD). Where ETD is not supported, you must print the commercial invoice.

Electronic submission will occur for the following countries (shipments to other countries must have printed commercial invoices):

  • 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)

Delivery Confirmation

Confirmation TypeAPI CodeDescription
Service defaultnoneNo confirmation requested.
No signature requireddeliveryDelivery confirmation is requested.
Indirect signature requiredsignatureSignature is required for the shipment to be delivered. This signature may be a neighbor, building manager, or the recipient can authorize the release of the package (without being present).
Adult signature requiredadult_signatureAn adult signature is required for the shipment to be delivered.
Direct signature requireddirect_signatureA signature of somebody at the address is required.

See our Delivery Confirmation page for more details about using the confirmation property.

Advanced Options

FedEx from ShipStation supports certain advanced options, which you can add to the shipment object when creating a shipment or label.

OptionTypeDefault ValueDescription
additional_handlingbooleannullIndicates the package requires special handling.
saturday_deliverybooleanfalseIndicates that the carrier should charge for delivery on Saturday for services that do not otherwise include Saturday delivery. The option for Saturday delivery is available for certain FedEx services. Some services may deliver on Saturday even without the Saturday delivery option selected.

To ensure you always have the most up-to-date information about a carrier's advanced options, use the list carrier options call.

Manifests

FedEx from ShipStation does not require or support manifesting your shipments with ShipStation API.

Scheduling Pickups

FedEx from ShipStation does not support scheduling pickups. All services are available in a drop-off version only. Merchants can drop packages off at FedEx points, but scheduling a pickup is not supported.

If merchants hand a FedEx Wallet package(s) to the courier during a scheduled pickup for another FedEx account, that pickup will incur a charge of $4.00 PER PACKAGE.

Service Points (PUDO)

FedEx from ShipStation does not support shipping to service points.

Tracking

FedEx from ShipStation supports receiving tracking updates. Review our ​Track a Package guides​​ for details on tracking with the ShipStation API.

Notes about FedEx from ShipStation

​​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

Taxes: ShipStation does not charge taxes for shipments using FedEx from ShipStation.

Third-party billing: FedEx from ShipStation does not support third-party billing.

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

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.