How to Set Up FedEx Carrier


In this article, we will describe how to connect FedEx parcel services (including Home Delivery, Ground, Express, Hold at Location, SameDay City and Air Freight services) or FedEx SmartPost to your ShipperHQ account. When setting up your FedEx carrier in ShipperHQ, you may want to utilize your negotiated rates with FedEx or use FedEx’s standard list rates to rate  packages/orders at checkout. If you want to use your negotiated rates, you’ll need certain credentials that will allow ShipperHQ to connect to the FedEx Web Services and obtain a rate quote. This article covers gathering the info you need, setting up FedEx in your ShipperHQ account, and info on how to best manage your connection between ShipperHQ and FedEx.

FedEx parcel services and FedEx SmartPost require different types of connections to FedEx. If using both types, you’ll need to set them up as separate Carriers in ShipperHQ as described in this article. FedEx LTL Freight is covered separately since the differences between it and the small packages services are more significant.


When connecting a FedEx Account with your negotiated rates to ShipperHQ, you’ll need certain credentials that will allow ShipperHQ to connect to the FedEx servers and obtain a rate quote. Follow the steps below to obtain your:

  • FedEx Account Number
  • FedEx Web Services Meter Number
  • FedEx Web Services Authentication Key
  • FedEx Web Services Password
  • If setting up SmartPost, FedEx SmartPost Hub ID

Register for a FedEx Online Account

If you already have a FedEx Online account connected to a FedEx Account, proceed straight to the Generating Credentials steps below. Otherwise, follow these steps to get those elements set up first.

  1. If you don’t have a FedEx Account and Account Number, you’ll need to contact FedEx, set up an account, and get your Account Number before proceeding.
  2. If you don’t have a FedEx Online account yet, go to and click the Sign Up button in the top right corner and set one up.
  3. If you haven’t yet connected your FedEx Online account to your FedEx Account, log in at and click your user name, choose “My Profile”, then choose “Account Management.” Here you can see if you already have your accounts linked or add an account if not.

Generating Credentials

You’ll also need a specific set of credentials to connect your FedEx Account to ShipperHQ which can be generated at the FedEx Web Services Developer Center following the steps below.

Note Even if you already have FedEx Web Services credentials, it’s recommended to follow these steps to create a new set of credentials for use with ShipperHQ. This will ensure that your existing connection is unaffected by your new connection.
  1. Go to the Register for Production Keys form and log in with your FedEx Online username and password (or continue if already logged in)
  2. Set Do You Intend to Reseller Your Software? to “No”
    1. Check the box for “FedEx Web Services for Shipping
    2. For Please indicate whether…  choose “Corporate Developer
    3. Click Continue
  3. Click Accept for the User Agreement
  4. Enter your FedEx Account Number and verify that the contact information is correct for your company or update if not then click Continue
  5. Do not check the box to update your profile, click Continue
  6. On the Confirmation page you’ll find your Authentication Key and Meter Number. These will be required when setting FedEx up in ShipperHQ, so save these in a secure location
  7. The last piece of information you need is the Password which will be sent to you by email with the subject “Your developer Production Key Registration is complete” to the email address on your FedEx Online account. This will be a random alphanumeric string and is different to your FedEx Online login password.

Now that you have your FedEx Web Services Authentication Key, Meter Number, and Password as well as your Account Number you can continue to Add This Carrier to ShipperHQ.

If using FedEx SmartPost, you’ll need to contact your FedEx SmartPost Account Representative to request that SmartPost rating is enabled for your Web Services credentials and request your Hub ID.

Steps To Add This Carrier

  1. Go to the Carriers page in the ShipperHQ dashboard
  2. Click + New to add a new carrier
  3. Select Live Rate Carrier
  4. Search for and select FedEx
  5. Name this carrier (this name will be the name your customers see in the Checkout.)
  6. You have two options for getting live rates from FedEx
    1. Standard List Rates
      Will not require you to enter any credentials and rates will be based on FedEx’s publish list rates. If you choose Standard List Rates click “Finish” and proceed to configuration. At any time, you can return to this carrier and enter your own account credentials to receive your negotiated rates.
    2. Use My Own FedEx Account Rates
      If you choose to use your own account, you will follow the rest of these instructions. 
  7. Success! Your FedEx carrier has now been added to your list of carriers in ShipperHQ.
  8. You may now proceed to Validate your FedEx Carrier (instructions are in the following section), or you can skip this step and choose to validate your carrier at another time. If you choose to skip validation you can begin to configure your carrier’s settings right away.

Steps to Validate This Carrier

In order for your live rate carrier to access live rates, you will need to enter your necessary credentials for FedEx and have them validated.

Validation, simply means that ShipperHQ was able to access the shipping account related to the credentials that you entered and retrieve rates.

If you choose to skip validation after adding your new carrier you will be reminded to add your credentials later.

To Validate your FedEx Carrier:

  1. Select Enter Credentials & Validate
  2. Review the information required to validate and Continue.
    1. If using SmartPost, you’ll need your Hub ID
    2. For required credentials, see the Generating Credentials section above
  3. Enter in the required credentials you have collected and click Validate
    Note: Successful installation depends on the accurate entry of the account information required FedEx. If you do not have the correct information you will not be able to validate your carrier and receive live rates.
  4. If validation is successful, you will be presented with:
    1. The option to enable your carrier right away. (Enabling your carrier at this time will turn its rates on immediately even before you have made any configuration adjustments to it.)
    2. Configure This Carrier. Continuing with this button will take you to the carrier’s configuration page. You can also enable the carrier from this page once you have saved your settings.
  5. If validation fails, the credentials you have already entered will still be saved so they will populate the form when you return. You can:
    1. Choose to try validation again and double-check that the information you entered is correct.
    2. Skip validation for now and complete it later. You will be reminded to complete validation later to get rates.
    3. Contact us if you are struggling to validate your carrier and you believe the credentials you are using are correct. We will be happy to help get you validated.

Moving from Test to Production Credentials

Once you’ve tested FedEx functionality using the Test Credentials generated above and are retrieving the services and rates you expect, you’ll need to generate Production credentials.

  1. Log in to the FedEx Developer Resource Center
  2. Choose “Move to Production” under “FedEx Web Services” on the left-hand nav bar
  3. Click “Get Production Key” and go through the registration process, at the end of this process you’ll receive your production credentials
  4. In ShipperHQ, input the credentials generated by FedEx. Be sure “Use Sandbox” is unchecked

FedEx Address Validation Service

ShipperHQ supports a variety of features around address validation including the ability to validate the address entered by your customers in the checkout, automatic address type lookup, and address suggestion. Address Validation is completely optional, but if you’d like to add it to your checkout process, you can enable the Address Validation or Dynamic Address Type Lookup Advanced Feature on ShipperHQ, using one of your Advanced Feature slots.  Enabling Address Validation or Type Lookup will result in fewer orders being sent to incorrect addresses and reduce charges from carriers for invalid addressing and address type.

The Address Validation Service is an advanced service available via FedEx Web Services and must be enabled by FedEx Customer Support for the production credentials used in ShipperHQ.

You’ll need to make sure you have your FedEx Account Number as well as the FedEx Web Services API Key and Meter Number you’re using in ShipperHQ handy as they may be needed to verify your request. Once you have those:

  1. Call the FedEx help desk at 877-339-2774
  2. At the prompt, say Web Services
  3. Once you’re routed to someone, ask for assistance with enabling the Address Validation Service for your web services credentials

Upon enabling the Address Validation Service through FedEx, you can proceed to enable and manage the Address Validation feature, with more information here.

FedEx Air Freight

FedEx Air Freight is a different service to FedEx LTL. It’s used to ship items over 150lbs or that exceed 70″ in height or 119″ in length or 80″ in width both internationally and domestic.

The methods are FedEx International Priority Freight, FedEx International Economy Freight or FedEx 1, 2 or 3 Day Freight and FedEx First Freight for domestic shipments.

To get started create a standard FedEx carrier following steps above.

Configure FedEx Carrier for Air Freight

In the package settings of the new FedEx carrier, ensure you set the Maximum Per Package Weight to be at least 151lbs, in reality, you will probably want to set it much higher than this. FedEx Air Freight will allow this value to be up to and including 2200lbs.

If any of your freight boxes are over 60 inches in any measurement, you will need to set the oversize Oversize Length Threshold to something higher than the default of 60″
You will also need to ensure you select the relevant freight methods listed above.


ShipperHQ connects to your FedEx account by generating FedEx credentials as described above which means that the shipping rates and options available through ShipperHQ should match the rates you get through FedEx ShipManager,, or any other tool you use to get rates or print labels for FedEx.

If you find that your rates through ShipperHQ are not matching what you expect to receive from FedEx, there are a number of troubleshooting steps that you can take to determine why this may be the case.

If you determine that the response from FedEx themselves, FedEx Web Services Support can be contacted at

Was this doc helpful?