Activating UPS Freight Credentials


Before getting rates back on a UPS Freight carrier in ShipperHQ, you’ll need to go through a process enforced by UPS to activate your UPS Freight credentials.

This document will walk you through the process of obtaining your UPS Freight credentials, running them through the UPS Freight Test process, and activating your UPS Freight carrier in ShipperHQ.

Obtaining UPS Freight Account & Setting Up your Carrier

UPS Freight Account Settings
UPS Freight Account Settings

To get rates from UPS Freight using ShipperHQ, you must have a UPS Freight test account. This is separate to your standard UPS account.

  1. Ensure you have a UPS XML Key and credentials
  2. Register for a test account on the UPS Freight site.
  3. If you haven’t done so already, create a UPS Freight carrier in ShipperHQ
  4. In the Account Settings panel of your UPS Freight carrier, enter your UPS Freight credentials and check the “Generate Test Rate” checkbox.
  5. Save your UPS Freight carrier in ShipperHQ

You now have your UPS Freight account set up in ShipperHQ to run through the UPS Freight account Test process.

With “Generate Test Rate” checked on your UPS Freight carrier in ShipperHQ, you’re now ready to obtain your test rate and register for activation with UPS.

Activating your UPS Freight credentials

In the next steps you’ll generate the required test rate and enter it on the UPS Freight website to activate your account.

    1. Disable all other carriers in ShipperHQ (if any) leaving only the UPS Freight carrier enabled
    2. On your website, add any product to your shopping cart and obtain a shipping rate using a Business address
    3. The UPS Freight rate you see is the UPS Freight Test Rate referenced above. Note this rate and continue with the process below.
    4. Login to the UPS Developer Kit
    5. Navigate to Access and Administration->Manage Access Keys
    6. Enter your current Access Key and select Request Production Keyups5NB: If you are presented with a notification window explaining that production access is not guaranteed and nothing happens when you click continue please re-try with an alternative web browser. We have had reports of this occurring with one web browser but not another.
    7. Select Rating-Ground Freight API


  1. Answer questions as appropriateups7
  2. Enter the Rate Value using the Total Shipment Charge obtained from the XML response.ups8
  3. Log back into ShipperHQ, uncheck “Generate Test Rate” on your UPS Freight carrier, and save your UPS Freight carrier
  4. If you disabled any other carriers when generating your test rate, you can now reenable them


You now have production access to the UPS Freight API and can continue setting up your UPS Freight carrier in ShipperHQ. We appreciate this is confusing for some but the constraints here are made by UPS, and not us.