# How to set up UPS
URL: https://support.starshipit.com/articles/360001297215-how-to-set-up-ups
Canonical: https://support.starshipit.com/articles/360001297215-how-to-set-up-ups
Markdown: https://support.starshipit.com/articles/360001297215-how-to-set-up-ups.md
Updated: 2026-06-14

> 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. Click **Save**.
9. Click **Test to ensure it works**.

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)