- Introduction
- Migration
- Preferences
- Test Account
- Service Types
- Packaging Types
- Reference Types
- Special Services
- International Shipping
- Upload Documents
- Returns
- Pickups
- Email Notifications
- FedEx Ground® Economy
- FedEx One Rate®
- Hazardous Materials
- Label Formats
- Limitations
- Error Messages
- Common Questions
Migration
FedEx has launched its RESTful APIs to provide a modernized customer experience. FedEx Web Services (SOAP-based) is now in development containment, meaning all new features and enhancements will only be available in RESTful APIs. For more information please see our FedEx Migration FAQ page.
To find information on the old FedEx XML API integration follow this link.
Preferences
In order to create a Preference for Fedex V2 in the Multi-carrier application you need to use the shipping/billing addresses linked to that account, as well as a recent invoice or a PIN.


IMPORTANT: When using the PIN option make sure to identify the contact phone number/email under the FedEx account and to have access to this phone number/email, or ask the person it belongs to assist you.
How to reauthenticate the account
If you start receiving authorization errors or just want to reauthenticate the account you can do that by going to the shipping preference > edit > and reauthenticate the account by reentering the FedEx invoice details or PIN.
FedEx Signature and Letterhead
Electronic Signature and Letterhead are required by FedEx for international shipping and will be applied to the commercial invoice. You need the set this up on the Preference. Go to Shipping Preferences and select your FedEx preference.
Click on the arrow and select FedEx Setup Signature and Letter Head.
Test Account
We provide a FedEx test account in the application, so you can test some functionalities without a live carrier account.
However, for best test results we always recommend using your own FedEx account. Your account won't be charged for shipments unless the label is scanned by the courier.
Service Types
Service Types | Value | |
---|---|---|
FedEx 1 Day Freight | fedex_1_day_freight | Copy |
FedEx 2 Day | fedex_2_day | Copy |
FedEx 2 Day AM | fedex_2_day_am | Copy |
FedEx 2 Day Freight | fedex_2_day_freight | Copy |
FedEx 3 Day Freight | fedex_3_day_freight | Copy |
FedEx Express Saver | fedex_express_saver | Copy |
FedEx First Freight | fedex_first_freight | Copy |
FedEx Freight Economy | fedex_freight_economy | Copy |
FedEx Freight Priority | fedex_freight_priority | Copy |
FedEx Ground | fedex_ground | Copy |
FedEx First Overnight | fedex_first_overnight | Copy |
FedEx Ground Home Delivery | fedex_ground_home_delivery | Copy |
FedEx Priority Overnight | fedex_priority_overnight | Copy |
FedEx Ground Economy Media Mail | fedex_smart_post_media_mail | Copy |
FedEx Ground Economy Parcel Select | fedex_smart_post_parcel_select | Copy |
FedEx Ground Economy Presorted Bound Printed Matter | fedex_smart_post_presorted_bound_printed_matter | Copy |
FedEx Ground Economy Parcel Select Lightweight | fedex_smart_post_presorted_standard | Copy |
FedEx Ground Economy Parcel Return | fedex_smart_post_parcel_return | Copy |
FedEx Standard Overnight | fedex_standard_overnight | Copy |
FedEx Europe First International Priority | fedex_europe_first_international_priority | Copy |
FedEx International Economy | fedex_international_economy | Copy |
FedEx International Economy Freight | fedex_international_economy_freight | Copy |
FedEx International First | fedex_international_first | Copy |
FedEx International Priority | fedex_international_priority | Copy |
FedEx International Priority Express | fedex_international_priority_express | Copy |
FedEx International Priority Freight | fedex_international_priority_freight | Copy |
FedEx Next Day Early Morning | fedex_next_day_early_morning | Copy |
FedEx Next Day Mid Morning | fedex_next_day_mid_morning | Copy |
FedEx Next Day Afternoon | fedex_next_day_afternoon | Copy |
FedEx Next Day End of Day | fedex_next_day_end_of_day | Copy |
FedEx Distance Deferred | fedex_distance_deferred | Copy |
FedEx Economy | fedex_economy | Copy |
FedEx Economy Freight | fedex_economy_freight | Copy |
FedEx Economy Select | fedex_economy_select | Copy |
FedEx International Deferred Freight | fedex_international_deferred_freight | Copy |
FedEx International Economy Distribution | fedex_international_economy_distribution | Copy |
FedEx International Priority Distribution | fedex_international_priority_distribution | Copy |
FedEx International Ground Distribution | fedex_international_ground_distribution | Copy |
FedEx SameDay | fedex_sameday | Copy |
FedEx SameDay City | fedex_sameday_city | Copy |
FedEx Transborder Distribution | fedex_transborder_distribution | Copy |
FedEx Next Day Freight | fedex_next_day_freight | Copy |
FedEx Regional Economy | fedex_regional_economy | Copy |
FedEx Regional Economy Freight | fedex_regional_economy_freight | Copy |
FedEx International Connect Plus | fedex_international_connect_plus | Copy |
FedEx First | fedex_first | Copy |
FedEx Priority | fedex_priority | Copy |
FedEx Priority Express | fedex_priority_express | Copy |
FedEx Priority Express Freight | fedex_priority_express_freight | Copy |
FedEx Priority Freight | fedex_priority_freight | Copy |
Europe first international priority | europe_first_international_priority | Copy |
FedEx Standard Overnight Extra Hours | fedex_standard_overnight_extra_hours | Copy |
FedEx Priority Overnight Extra Hours | fedex_priority_overnight_extra_hours | Copy |
FedEx First Overnight Extra Hours | fedex_first_overnight_extra_hours | Copy |
Packaging Types
Packaging Types | Value | |
---|---|---|
Your Packaging | your_packaging | Copy |
Fedex envelope | fedex_envelope | Copy |
Fedex box | fedex_box | Copy |
Fedex small box | fedex_small_box | Copy |
Fedex medium box | fedex_medium_box | Copy |
Fedex large box | fedex_large_box | Copy |
Fedex extra large box | fedex_extra_large_box | Copy |
Fedex 10 KG box | fedex_10kg_box | Copy |
Fedex 25 KG box | fedex_25kg_box | Copy |
Fedex pak | fedex_pak | Copy |
Fedex tube | fedex_tube | Copy |
Upload Documents
It is possible to upload documents created outside of the Multi-Carrier application. The documents need to be stored on your original object, so for example if you are shipping from an Order object, you need to store the files that you would like to upload on the Order object under the Notes and Attachments or the Files related list. You also need to name the file according to the document type.
Returns
It is possible to create a Custom Address Source specifically for returns. (If you need help setting up a Custom Address Source please use this guide.) In the Custom Address Source the Shipment Type should be set to Return.

QR code returns
QR code returns are currently not available for FedEx V2, we are working with FedEx to have this in our integration..
FedEx Ground® Economy
FedEx Ground® Economy is formerly known as SmartPost® is a customized solution offered by the carrier, where FedEx deliver your packages to a USPS facility for final delivery by a postal carrier
1. Setup
Your FedEx account must already be Ground® Economy enabled before you can start creating Ground® Economy labels. If it's not already enabled, then please contact your FedEx account manager to get this set up.
To enable the Ground® Economy options on the shipping wizard you will need to create/update your FedEx shipping preference to check the Setup for FedEx Ground® Economy checkbox and include the FedEx Ground® Economy Hub ID.

2. Ground® Economy Options
Once you are on the shipping Wizard page, in section 4 you can select the Ground® Economy service type:
- FedEx Ground® Economy Parcel Select - PARCEL_SELECT
- FedEx Ground® Economy Parcel Select Lightweight - PRESORTED_STANDARD
- FedEx Ground® Economy Bound Printed Matter - PRESORTED_BOUND_PRINTED_MATTER
- FedEx Ground® Economy Media - MEDIA_MAIL
Depending on the Indicia type you use, your next choice is related to the Ancillary Endorsement. This lets FedEx know what to do with undelivered packages.
Here are the options:
- Address Correction - ADDRESS_CORRECTION
- Carrier Leave If No Response - CARRIER_LEAVE_IF_NO_RESPONSE
- Change Service - CHANGE_SERVICE
- Forwarding Service - FORWARDING_SERVICE
- Return Service - RETURN_SERVICE
*Note that not all options are available for all Indicia types.
FedEx One Rate®
You can ship using FedEx One Rate® with the following Packaging Types for domestic US shipments.
- FedEx Envelope
- FedEx Extra Large Box
- FedEx Large Box
- FedEx Medium Box
- FedEx Small Box
- FedEx Pak
- FedEx Tube
You can select it under Special Services,

or you can default it in the Custom Address Source.

Hazardous Materials
You can add dangerous goods to your shipment by selecting the special service in the wizard or mapping
it in the CAS under the specific carrier fields section.
Once the special service is selected you need to select the dangerous goods type.
Express services have two options: hazardous_materials, limited_quantity
Ground services have three options: hazardous_materials, battery, excepted_quantity


If needed, you can also add the regulation set: adr, dot, iata, ormd


Now it is time to fill in the dangerous goods details. Depending on the service type and dangerous goods type the available fields change. You can view all available fields in the wizard by clicking on the four-way arrow or by searching "dangerous goods" in the searchbox in the Packages section and the specific carrier fields section of the CAS.


You can also specify the HazMat detail if you want to but this is not required. If you want to specify
this, then you first need to go to the Dangerous Goods tab.
If you are migrating from the old FedEx API you can continue using your existing Dangerous Goods
Details, otherwise you need create a new one.

Fill in as much information as you can on the next page then save your new Detail.

You also need to add the signatory information.


Common Questions
In this section you can find our most commonly asked questions regarding this carrier. If you have a question not listed here please contact us.