How to Set Up FedEx Carrier


In this article, we 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 allow ShipperHQ to connect to 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 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 from 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. Log into your ShipperHQ account.
  2. Navigate to the Manage Shipping > Carriers dashboard.
  3. Click the + New to add a new carrier.
  4. Click the Live Rate Carrier option.
  5. Select FedEx from the list of carriers.
  6. Type in the name of the carrier you want your customers to see. Example: FedEx.
  7. Click the Continue button.
  8. Success! Your FedEx carrier has now been added to your list of carriers in ShipperHQ.
  9. 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 negotiated rates, you need to enter your credentials for FedEx and have them validated. This validation process means ShipperHQ can access the shipping account and retrieve rates.

If you choose to skip validation after adding your new carrier, you are reminded to add your credentials later. Note, you can still use and configure this carrier without validating your credentials. In this scenario, ShipperHQ uses the standard FedEx list rates instead of your negotiated rates.

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 validation depends on the accurate entry of the account information required by FedEx. If you do not have the correct information, you cannot validate your carrier and receive your negotiated rates.
  4. If validation is successful, you are presented with:
    1. Configure This Carrier – continuing with this button redirects you to the carrier’s configuration page. You can also enable the carrier from this page once you have saved your settings.
    2. Negotiated Rates – the negotiated rates checkbox is automatically selected.
  5. If validation fails, the credentials you have already entered are saved, and auto-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 are 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 navbar
  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?