UPS Credentials

Get API credentials from UPS to display live UPS shipping rates in your checkout.

Important: UPS has transitioned to OAuth 2.0 authentication and no longer issues new Access Keys. All integrations now use Client ID and Client Secret. If you have an existing Access Key-based integration, you should migrate to OAuth 2.0.

What You Need

• Active UPS shipping account
• UPS account number (6 or 9 digits, found on your invoice or UPS.com profile)
• Access to UPS Developer Portal

Step-by-Step Setup

1. Create Developer Account

1. Go to UPS Developer Portal
2. Click "Sign Up" (or "Log In" if you have account)
3. Complete registration with your business details
4. Verify email address

2. Request API Access

1. Log into UPS Developer Portal
2. Go to "My Apps"
3. Click "Add App"
4. Enter application details:
   • App Name: "RateTell Integration" (or your store name)
   • Description: "Shipping rate integration"
5. Select API products:
   • Authorization (OAuth) — required for authentication
   • Rating API — required for live rates
   • Address Validation — recommended
6. Accept terms and conditions
7. Click "Create App"

3. Get Your Credentials

After creating your app, you'll receive OAuth 2.0 credentials:

• Client ID (API Key)
• Client Secret (API Password)

You'll also need:

• Account Number — your UPS shipper account number (found on invoices or in your UPS.com profile under Account Management)
• Origin Address — your warehouse or shipping location

4. Add to RateTell

1. Log into your RateTell dashboard
2. Go to Carriers in the sidebar
3. Click "Connect" on the UPS card
4. Enter credentials:
   • Client ID: Paste from developer portal
   • Client Secret: Paste from developer portal
   • Account Number: Your UPS shipper number
5. Enter Origin Address:
   • Complete warehouse/shipping address
   • Include postal code (required for rates)
6. Click "Test Connection"
7. If successful, click "Save"

Testing Your Setup

Test Mode

UPS provides a testing environment so you can try out the connection before going live:

1. Enable Test Mode in RateTell carrier settings
2. Use your test credentials from the UPS developer portal
3. Test rates won't affect your live shipping
4. Switch to Production Mode when ready

Verify Connection

The "Test Connection" button confirms your credentials are correct and your account is active.

Troubleshooting

Invalid Credentials: Ensure you are using the modern Client ID and Client Secret from your developer app, not an old Access Key.

OAuth Authentication Failure: Verify that Authorization (OAuth) and Rating are selected under your app's API products in the developer portal.

No Rates Returned: Confirm your Account Number is correct and origin address includes a valid postal code.

Access Denied: Wait 10-15 minutes after creating your app for activation to complete.

Next Steps

• Configure Carrier Rates
• Test Your Setup
• How Landed Cost Works

---

Need help? Email support@ratetell.com