Articles in this section

Set up a connection to UPS

Naga Sri Hari Gonaboyina
Updated

United Parcel Service (UPS) is a package delivery company that offers the transportation of packages and freight and facilitation of international trade.

Set up a connection

After you start the connection, configure it in the Create connection panel and complete all of the required * authentication settings:

Setting

Instructions

Name your connection * 

Enter a clear and distinguishable name. Throughout integrator.io imports and exports, you will have the option to choose this new connection. A unique identifier will prove helpful later when selecting it from a list of the connections in your account.

Environment * 

Select your UPS account environment (Production or Test).

Auth type * 

Select your UPS account authentication type (Custom or OAuth 2.0).

Subversion * 

Enter the UPS subversion.

The subversion is used whenever the UPS introduces new elements in the response that are not associated with the new request element. It ensures backward compatibility and is used for endpoints like the package, freight shipping, and label recovery. For information on how to get the subversion, see Developer APIs for the required endpoints.

Custom authentication 

Username * 

Enter your UPS account user ID.

Password * 

Enter your UPS login password.

Multiple layers of protection, including AES 256 encryption, are in place to keep your password safe. When editing this connection, you must re-enter this value each time; it is stored only when the connection is saved and never displayed as text.

Access license number * 

Enter your access license number provided by UPS while onboarding. Contact your UPS support representative for more information.

Multiple layers of protection, including AES 256 encryption, are in place to keep your access license number safe. When editing this connection, you must re-enter this value each time; it is stored only when the connection is saved and never displayed as text.

OAuth 2.0 authentication 

OAuth 2.0 client * 

Select the OAuth 2.0 client that stores the client ID and client secret provided to you by UPS.

To add an OAuth 2.0 client and configure your credentials, click the plus (+) button. Click the edit (pencil.svg) button to modify a selected OAuth 2.0 client. For more information, see Create an OAuth 2.0 iClient resource

dataLoad.svg​​ How to retrieve the client ID and client secret

Inquiry number * 

Enter your UPS Inquiry number.

Tip

This connector documentation describes only the settings shown for the Simple view. For the corresponding HTTP settings, see the Custom auth universal connector documentation.

How to retrieve the client ID and client secret

  1. Sign in to your UPS developer account.

  2. Navigate to My apps.

  3. Click Add app and enter an App name.

  4. Enter Celigo integrator.io Callback URL.

  5. Select the Billing account number.

  6. Click Save.

  7. Copy the Client ID.

  8. Copy the Client secret.

Additional references