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
Service | API Code |
---|---|
FedEx Ground® | fedex_ground |
FedEx Economy | fedex_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 Rate | fedex_2day_one_rate |
FedEx Express Saver® One Rate | fedex_economy_one_rate |
FedEx Standard Overnight® One Rate | fedex_standard_overnight_one_rate |
FedEx Priority Overnight® One Rate | fedex_priority_overnight_one_rate |
FedEx Ground® Economy Parcel Select | fedex_ground_economy_parcel_select |
International Services
Service | API Code |
---|---|
FedEx International Economy® | fedex_international_economy |
FedEx International Priority® | fedex_international_priority |
FedEx International Priority® Express | fedex_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:
Name | API Code | Package Attributes |
---|---|---|
FedEx® Box | fedex_box | International, Domestic |
FedEx® Envelope | fedex_envelope | International, Domestic |
FedEx® Pak | fedex_pak | International, Domestic |
FedEx® Tube | fedex_tube | International, Domestic |
FedEx® 10kg Box | fedex_10kg_box | International |
FedEx® 25kg Box | fedex_25kg_box | International |
FedEx® Small Box | fedex_small_box | Domestic |
FedEx® Medium Box | fedex_medium_box | Domestic |
FedEx® Large Box | fedex_large_box | Domestic |
FedEx® Extra Large Box | fedex_extra_large_box | Domestic |
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 Type | API Code | Description |
---|---|---|
Service default | none | No confirmation requested. |
No signature required | delivery | Delivery confirmation is requested. |
Indirect signature required | signature | Signature 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 required | adult_signature | An adult signature is required for the shipment to be delivered. |
Direct signature required | direct_signature | A 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.
Option | Type | Default Value | Description |
---|---|---|---|
additional_handling | boolean | null | Indicates the package requires special handling. |
saturday_delivery | boolean | false | Indicates 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.