Skip to main content

How to set up the UPS integration

A step by step guide on how to set up the UPS integration in Returbo

This is a guide on how to set up the UPS integration in Returbo. UPS requires that you create an app in their developer portal with a callback URL as well as do a two-step verification.

How to find your UPS credentials

How to get the Client ID and Client Secret

The Client ID and Client Secret are used to obtain an access token. This token is passed as a bearer token in your API requests to authorize them.

⚠️ Note:The UPS username used when creating the credentials is tied to the OAuth credentials. Only shipper accounts associated with that username will work with APIs such as Ship and Rate.
  1. Log in to the UPS Developer Website

  2. Click “Create an Application”

  3. Click “Add Apps”

  4. Select “I want to integrate UPS technology into my business”
    Then choose the UPS account you want to use for return shipping slips.

  5. Fill in your company information
    (You do NOT need to select “I’d like to subscribe to API status & updates emails”)

  6. Configure your app:

    1. Name the app Returbo (or any name you prefer)

    2. Callback URL:
      https://returboapp.com/ups-activation

    3. Add the following products:

      • Rating

      • Pickup

      • Address Validation

      • Paperless Documents

      • Authorization (OAuth)

      • Tracking

      • Locator

      • Shipping

7. Click Save

After saving, you will see your:

  • Client ID

  • Client Secret

👉 Copy these, along with:

  • UPS account number

  • Phone number associated with the account

Add them to your Returbo credentials.


What is the account number and how do I find it?

You can find your UPS account number in several ways:

Option 1: Invoice

  • Check any UPS invoice or statement

  • Look for a 6-digit number

Option 2: UPS website

  1. Log in to your UPS account

  2. Go to View My Invoice

  3. Open an invoice PDF

  4. Look for “Shipper Number” (top right corner)

Option 3: Tracking number

  • UPS tracking numbers start with “1Z”

  • The next 6 characters are your account number
    (usually 3 letters + 3 numbers)

Still can’t find it?

Contact UPS customer support


What phone number should I use?

Use the phone number associated with your UPS account.

Did this answer your question?