> ## Documentation Index
> Fetch the complete documentation index at: https://docs.neoagent.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Connecting UPS to Neo

> Create a UPS Developer Portal app and save its Client ID, Client Secret and your account number in Neo

You connect UPS once at the MSP level, with an app in the UPS Developer Portal that is linked to your UPS shipper account.

## 1. Create the app in the UPS Developer Portal

**1. Sign in**

Go to [developer.ups.com](https://developer.ups.com) and sign in with the ups.com login that holds your shipper account.

**2. Create the app**

Open **My Apps** and click **Add Apps**. Choose that you want to integrate UPS technology into your business, and pick the shipper account the labels bill to.

**3. Add the API products**

Add at least **Authorization (OAuth)**, **Tracking**, **Shipping**, **Address Validation**, **Rating** and **Time in Transit**. Add **Pickup**, **Locator**, **Delivery Intercept**, **Landed Cost** or **Paperless Documents** if your agents need them. A call to an API the app does not hold fails with an authorization error.

**4. Copy the keys**

Open the app and copy its **Client ID** and **Client Secret**. Keep the secret out of email and chat.

Your UPS account number is the six letters and digits of your shipper account, such as `1A2B3C`. It is on your UPS invoices and under Account Summary on ups.com, and it must be the account linked to the app.

Neo signs in at `https://onlinetools.ups.com` with the Client ID and Client Secret, and bills each label to the account number you save.

## 2. Add UPS in Neo

**1. Open Integrations**

In the Neo Dashboard, open **Integrations** and find the UPS card, under Other.

**2. Save the keys**

Enter the Client ID, the Client Secret and your UPS account number, and click **Save settings**. Neo signs in to UPS before saving, so a wrong Client ID or Client Secret is rejected straight away.

## 3. Turn UPS on per agent

Open the agent, go to the Integrations section, and pick an access profile for the UPS block, or set each area yourself:

| Area | Access levels you can pick | Notes |
| - | - | - |
| **Shipments & Labels** | Disabled, Read Only, Read / Write | Creating and voiding labels needs Read / Write. |
| **Tracking** | Disabled, Read Only, Read / Write | Tracking needs Read Only. Read / Write subscribes tracking numbers to UPS Track Alert. |
| **Rates, Transit Times & Addresses** | Disabled, Read Only | Address checks, rates and transit times. |
| **Pickups** | Disabled, Read Only, Read / Write | Booking and cancelling pickups needs Read / Write. |
| **Delivery Changes** | Disabled, Read Only, Read / Write | Redirects, holds and returns of a parcel on its way. Each is billed a fee. |
| **Customs & Trade** | Disabled, Read Only, Read / Write | Duty quotes, export guidance and customs details. |
| **Freight & Supply Chain** | Disabled, Read Only, Read / Write | Only for accounts enrolled in UPS Forwarding, TradeDirect, WorldEase or UPS Supply Chain Solutions. |

Then add your ship-from address and box size to the agent's instructions, as [UPS](https://docs.neoagent.io/integrations/ups/overview.md) says. See [UPS API](https://docs.neoagent.io/agents/tools/management/ups-api.md) for the profiles.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.