Upgrading Your FedEx Connection to REST API (MFA)

As part of FedEx deprecating their XML API, all existing FedEx connections in ShipHero must be upgraded to the new REST API using a multi-factor authentication (MFA) flow. This must be completed for every warehouse/profile connection for that FedEx account. If you are setting up FedEx for the first time, see Connecting Your FedEx Account to ShipHero.

Table of Contents

• Upgrading Existing Connections
• Step-by-Step FedEx Upgrade Process
• FedEx MFA Methods Explained
  • PIN Validation
  • Invoice Validation
  • Tech Support Call
• FedEx MFA Process Flow: US and Canada

Upgrading Existing Connections

As part of FedEx deprecating their XML implementation, customers will have to go through a multi-factor authentication (MFA) flow to generate credentials for their new REST API before March 16, 2026 to continue using FedEx services. This must completed for every warehouse/profile connection for that FedEx account.

If you receive an error regarding the address on your account when trying to upgrade to the new MFA process please reach out to FedEx Support, they can assist with verifying the address in their system.

Step-by-Step FedEx Upgrade Process

1. Navigate to the Shipping > Carriers page and select the Upgrade MFA button next to the FedEx connection.

   

2. In the pop-up module, input the required information, marked with an asterisk, and select your preferred MFA Method. Explanations of each option are listed below.

   

   Required Information:

   FedEx customer name Country code State/province code

   City Postal code  Address line 1

   To find the required information: Login to your FedEx account and open the contact information page.

3. Accept the FedEx EULA terms and conditions and select the Upgrade button. The MFA method selected will determine the finishing steps.

FedEx MFA Methods Explained

There are three FedEx MFA methods available when connecting your FedEx account to ShipHero:

1. PIN validation
2. Invoice validation
3. Tech support call

A visual example of FedEx's MFA Process Flow for US and Canadian accounts can be found after the sections where these methods are defined.

PIN Validation

If the PIN validation MFA option is selected, you will need to select a method for receiving a PIN, and input the PIN once received. Once completed, click the Upgrade/Connect button again.

• Email: Sent to the email registered in the FedEx dashboard
• SMS: Sent to the phone number registered in the FedEx dashboard
• Call: Customers will receive a call to the phone number registered in the FedEx dashboard.

Invoice Validation

If the Invoice validation MFA method is selected, you will need to provide information from a recent invoice (no older than 60 days). Then select the Upgrade/Connect button.

Required information:

• Invoice number
• Invoice currency
• Invoice amount
• Invoice date (YYYY-MM-DD)

Tech Support Call

If the Tech Support Call MFA method is selected, you will need to call FedEx's Tech Support Line (+1 877-339-2774) to receive clearance on FedEx's side to skip the MFA validation methods. After the call, repeat the address validation step and re-select the "Tech Support Call" MFA Method, and the connection will continue automatically when you select the Upgrade/Connect button.

FedEx's MFA Process Flow: US and Canada only

Important Reminders when Connecting a Carrier Account

• Using Custom Profiles: Custom profiles allow you to connect the same carrier account multiple times with unique settings, such as specific Incoterms or 3rd Party Billing. For these settings to apply, the order must be assigned to that specific profile. If the assigned profile lacks a connected carrier, ShipHero will automatically use the carrier account connected the warehouse’s default profile for the selected shipping method. This ensures your specialized billing and shipping terms are applied correctly to every label. Visit the following article for more information on How to Use Warehouse Profiles.
• Multi-Warehouse Accounts: To generate labels from multiple warehouses, you must connect your carrier account to each individual location in ShipHero to avoid shipping errors or billing discrepancies. Please consult your carrier to determine if a single account number supports multiple origins or if unique accounts are required for each site. This is especially critical for international locations, as carrier operations vary by country.
• Note for 3PLs: When connecting a new carrier account to ShipHero, double check your 3PL Clients' Settings to ensure you are connecting the carrier account to the correct ShipHero account; if Use Customer's Shipping Accounts is enabled the carrier account must be connected at the child account level, if Use Customer's Shipping Account is not enabled, the carrier account needs to be enabled at the 3PL level. More information about Managing 3PL Client Settings can be found here.