ShipRush

UPS OAuth FAQ

 

What is OAuth?

OAuth (Open Authorization) is an industry-standard protocol that can allow Descartes ShipRush to connect to UPS™ without sharing credentials. This particular ShipRush-to-UPS connection is used for creating shipping labels. (In the past, UPS used different authorization protocols, but has since retired them for the newer OAuth process.)

 

Where are the instructions for registering my UPS account(s) for the OAuth Process?

Go to the UPS OAuth Migration Guide.

 

When do I have to update my UPS credentials?

UPS requires all shippers to update to the new OAuth process by June 3rd, 2024.

 

What will happen if I do not update my account by the June 3rd, 2024 deadline?

UPS has indicated that you will not be able to generate labels until you update to the new authorization protocol. You will receive an error message when trying to ship with UPS.

 

Does each account have to be registered for the OAuth Process?

Yes. If you have multiple UPS accounts enabled, you need to complete the OAuth process for each one.

 

If I am disconnected from UPS while completing the authentication process, what do I do?

Close the window, and then restart the process in the UPS OAuth Migration Guide.

 

What do I do if I do not know my UPS username and/or password?

Go to the UPS.com login page. Click the Forgot your username/password button, and then follow the prompts.

 

What do I do if I do not know my UPS Account number?

Contact UPS customer service (1-800-742-5877) or your local UPS sales representative.

 

I have authenticated, but received the following error when trying to book a label: 'Missing or invalid shipper number'. What do I do?  

The error means that the username used to authenticate is not tied to your registered UPS account number. To resolve this issue, return to the Settings page, and reset your registered Authentication code. Then, register again through the same process using the UPS profile that corresponds to the UPS account. 

 

I have migrated my account but want to return/reset to the old UPS OAuth method. What do I need to do?

In ShipRush, go to the Settings page of your UPS account where you will see the screen with the Reset UPS Auth Code button.

  1. You need to file your email address in the given field.
  2. Click Reset UPS Auth Code.
  3. You will be migrated back to the old OAuth method.

Note: On UPS.com, you can verify your authentication by going to Profile > Accounts and Payments, if the UPS.com login you are using is attached to the account number used for shipping. If you do not see this information or have questions, please contact UPS support at 1-800-742-5877.

Back to Top