# Migrate UPS from Access Key to OAuth 2.0
URL: https://support.starshipit.com/articles/90200000000128-migrate-ups-from-access-key-to-oauth-20
Canonical: https://support.starshipit.com/articles/90200000000128-migrate-ups-from-access-key-to-oauth-20
Markdown: https://support.starshipit.com/articles/90200000000128-migrate-ups-from-access-key-to-oauth-20.md
Updated: 2026-06-15

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

> Move UPS from the legacy Access Key authentication model to OAuth 2.0 in Starshipit.

Migrate your UPS integration from the legacy Access Key authentication model to OAuth 2.0 when you need to update how Starshipit connects to UPS.

## Before you begin

Make sure you have your UPS username, UPS password, and UPS shipper number. Note any advanced UPS settings you use, because you need to reselect them after authorising the new integration.

## Migrate to OAuth 2.0

1. Go to **Settings > Couriers > UPS**.
2. Under **UPS API Version**, click **Use UPS (New)**.
3. Click **Authorize**.
4. Sign in on the UPS login page with your UPS username and password.
5. Wait to be redirected back to the UPS settings page in Starshipit.
6. Click **Save**.
7. Click **Test to ensure it works**.
8. Re-enable any advanced settings your workflow requires.

If the connection succeeds, Starshipit shows **Successful** on the UPS settings page.

## Verify the migration

Create or open a test order and confirm the expected UPS services appear. If a service does not appear, check your UPS product codes and advanced settings.

## Related articles

- [How to set up UPS](/articles/360001297215-how-to-set-up-ups)
- [UPS product codes](/articles/90200000000129-ups-product-codes)
- [UPS troubleshooting](/articles/90200000000132-ups-troubleshooting)