# Set up UPS
URL: https://support.starshipit.com/articles/360001297215-set-up-ups
Canonical: https://support.starshipit.com/articles/360001297215-set-up-ups
Markdown: https://support.starshipit.com/articles/360001297215-set-up-ups.md
Updated: 2026-09-06

> For the complete documentation index, see [llms.txt](https://support.starshipit.com/llms.txt).

> Connect UPS to Starshipit with OAuth 2.0, add product codes, and confirm the integration works.

Connect UPS to Starshipit with OAuth 2.0 so you can create domestic and international UPS shipments from Starshipit.

## Before you begin

Make sure you have:

- A UPS username.
- A UPS password.
- Your UPS shipper number.
- Access to a UPS account that supports API integrations.
- The UPS product codes you want to use.

:::note
CampusShip UPS accounts are not supported for API integrations.
:::

## Connect UPS

1. Go to **Settings > Couriers > Add a new courier > UPS**.
2. Select **Enable UPS**.
3. Toggle to **Use UPS new**.
4. Enter your **UPS Shipper number**.
5. Click **Authorize**.
6. Sign in on the UPS login page with your UPS username and password.
7. Wait to be redirected back to the UPS settings page in Starshipit.
8. The OAuth connection is already saved. Click **Test to ensure it works**.

The **Save** button is only available after you change a setting, such as **Enable UPS** or your **UPS Shipper number**.

If the connection succeeds, Starshipit shows **Successful** on the UPS settings page. If you are not redirected back to Starshipit, see [UPS troubleshooting](/articles/90200000000132-ups-troubleshooting).

## Configure UPS services

After you connect UPS, add the UPS product codes you want to use.

1. Go to **Settings > Couriers > UPS**.
2. Add your UPS product codes.
3. Go to **Advanced** and enable any settings your workflow requires.
4. Click **Save**.
5. Create or open a test order and confirm the expected UPS services appear.

For product codes by country or territory, see [UPS product codes](/articles/90200000000129-ups-product-codes).

## Migrate from UPS Legacy

Use the UPS OAuth 2.0 integration for new UPS setups. If you are migrating from the legacy Access Key integration, you need to reselect your advanced settings after authorising the new integration.

For migration steps, see [Migrate UPS from Access Key to OAuth 2.0](/articles/90200000000128-migrate-ups-from-access-key-to-oauth-20).

## Troubleshooting

If authorisation fails, the redirect does not complete, or a UPS service does not appear, check [UPS troubleshooting](/articles/90200000000132-ups-troubleshooting).

## FAQ

<!-- faq:start -->
<!-- faq:question -->Can I use a UPS DAP account via EasyPost for Starshipit?<!-- /faq:question -->

No. Starshipit only supports direct UPS account integrations.

<!-- faq:question -->Can I submit additional shipping documentation for UPS orders?<!-- /faq:question -->

Yes, but additional documents need to be printed outside Starshipit and placed in a sleeve on the outside of the package.
<!-- faq:end -->

## Related articles

- [UPS product codes](/articles/90200000000129-ups-product-codes)
- [UPS returns](/articles/90200000000130-ups-returns)
- [UPS additional settings](/articles/90200000000131-ups-additional-settings)
- [UPS dangerous goods](/articles/8457265587343-ups-dangerous-goods)
- [Securing UPS credentials](/articles/360001435636-securing-ups-credentials)

## Configure UPS settings

| Setting | What it does |
| --- | --- |
| Enable UPS | Turns the UPS connection on. |
| Integration | Choose Legacy API or New API. New API setup uses UPS authorisation; legacy setup uses the credential fields shown for that mode. |
| Shipping number | Identifies your UPS shipper account. |
| User ID, Password, and Access license number | Authenticate the legacy UPS API. |
| Use staging URL | Uses the UPS test endpoint where supported. |
| Product codes and Return product codes | Add the outbound and return UPS services available on your account and mark defaults. |
| Advanced settings | Configure duties and taxes payer, negotiated rates, generic descriptions, archived-order cancellation, NAFTA/paperless documents, declared value, net-cost dates, transportation payment, producer information, and dangerous-goods defaults. |
| Dangerous goods | Add the required commodity, classification, packaging, weight, and regulatory values for each UPS dangerous-goods entry. |
| Tools > Cancel shipment | Enter a tracking number to request cancellation. |