Connecting your United Parcel Service (UPS) account to ShipHero lets you use your negotiated UPS rates, generate shipping labels, and get automated tracking updates through the UPS API.
For a full breakdown of what UPS supports in ShipHero, see Overview: UPS in ShipHero.
UPS Worldwide Economy DDU Suspended to the EU
As of June 28, 2026, UPS suspended Worldwide Economy Delivered Duty Unpaid (DDU) service to European Union countries. Shipments sent with this service to an EU destination are returned to the shipper, adding cost and delay. Switch to Worldwide Economy DDP or an Expedited service for EU orders. See Understanding DDU and DDP in ShipHero.
Before You Begin
Before connecting your UPS account, make sure the following are set up on the UPS side:
- Active UPS.com Account (Profile): an active UPS.com login credential (username and password).
- Valid UPS Account Number (Shipper Number): a 6- to 10-digit alphanumeric billing ID linked to your UPS.com user profile.
To verify your UPS Account Number is linked to your profile:
- Log in to UPS.com using your credentials.
- Navigate to your User Menu (top right) and select Accounts and Payment.
- Verify that your active UPS Account Number is listed. If it isn't, select Add a Payment Method and follow the prompts to link it.
Negotiated rates between UPS and ShipHero are available only to customers who meet UPS prerequisites, operate warehouses within the United States, and use ShipHero WMS to process UPS labels. Contact your CSM or Support@shiphero.com to get connected with our Carrier Analyst.
Table of Contents
How to Connect UPS to ShipHero
The integration uses the UPS API to establish a secure link and retrieve real-time rates and label generation capabilities. The connection process uses OAuth 2.0 for secure authentication.
Step 1: Connect the UPS Account in ShipHero
- Go to the Shipping > Carriers page and click the Connect Carrier button.
- Select UPS from the list of available carriers.
- Enter your account credentials. Required fields are marked with an asterisk (see Required UPS Connection Fields below).
- Click Connect.
Step 2: Complete the UPS OAuth Authentication
Upon selecting Connect:
- You're redirected to the official UPS.com website to start the OAuth handshake.
- You're prompted to re-enter your UPS.com password to confirm your identity.
- You're asked to agree to the UPS Technology Agreement, which grants ShipHero authorization to access your UPS shipping account data (rates, label creation, tracking) on your behalf.
- Click Continue or Authorize.
Step 3: Verify the UPS Connection
- You're redirected back to the ShipHero Shipping > Carriers page.
- The UPS carrier connection now appears in your Connected Carriers list.
Required UPS Connection Fields
| Field | Description |
|---|---|
| Profile (Required) | Profiles apply different settings to a carrier connection so they only affect orders with that profile selected. Learn more in How to Use Warehouse Profiles in ShipHero. |
| Warehouse (Required) | The physical warehouse the account is connected to. If you have multiple warehouses, carrier connections are managed separately for each. |
| Account Number (Required) | Your UPS Account Number (Shipper Number). |
| Deliver Duty Paid | When enabled, ShipHero charges the connected account for international duties and fees. This is required for UPS Worldwide Economy shipments to the EU following the DDU suspension. Learn more in Understanding DDU and DDP in ShipHero. |
| 3rd Party Billing Fields | Used when carrier fees should be charged to a different account than the one connected. After connecting, configure the 3rd party account to be charged for shipping labels, duties and taxes, or both. Learn more in Overview: 3rd Party Billing Shipping Accounts in ShipHero. |
| USPS Endorsement for Mail Innovations | Required when setting up a UPS Mail Innovations account. Learn more in How to Set Up UPS Mail Innovations. |
| Cost Center | Required when setting up a UPS Mail Innovations account. Learn more in How to Set Up UPS Mail Innovations. |
Available UPS Settings After Connecting
| Setting | Description |
|---|---|
| Cut-Off Time | Determines the shipping date printed on the label. Once the cut-off time passes, ShipHero generates labels for the following day. Set this to match your carrier pick-up time. |
| Enable SurePost | Your UPS representative must enable this on your UPS account before you can use it in ShipHero. |
| UPS Carbon Neutral | Labels created with this profile are UPS carbon neutral. UPS charges per package for this option. |
| Disable Quoting | Excludes this carrier from quoting and cheapest rate calculations. |
| 3rd Party Billing Fields (Shipping Charges) | Populates automatically if you entered third-party billing information during connection. When DDP is enabled, ShipHero bills shipping charges and duties and taxes to this account; you don't need to re-enter the information in the duties fields. Learn more in Overview: 3rd Party Billing Shipping Accounts in ShipHero. |
| 3rd Party Billing Fields (Duties and Taxes) | Use these fields to charge duties and taxes to a different account than the one charged for shipping fees. Information from the connection page does not carry over to these fields automatically. Learn more in Overview: 3rd Party Billing Shipping Accounts in ShipHero. |
Running into an error after connecting? See Troubleshooting: UPS Errors and Limitations.
Important Reminders when Connecting a Carrier Account
- Using Custom Profiles: Custom profiles allow you to connect the same carrier account multiple times with unique settings, such as specific Incoterms or 3rd Party Billing. For these settings to apply, the order must be assigned to that specific profile. If the assigned profile lacks a connected carrier, ShipHero will automatically use the carrier account connected the warehouse’s default profile for the selected shipping method. This ensures your specialized billing and shipping terms are applied correctly to every label. Visit the following article for more information on How to Use Warehouse Profiles.
- Multi-Warehouse Accounts: To generate labels from multiple warehouses, you must connect your carrier account to each individual location in ShipHero to avoid shipping errors or billing discrepancies. Please consult your carrier to determine if a single account number supports multiple origins or if unique accounts are required for each site. This is especially critical for international locations, as carrier operations vary by country.
- Note for 3PLs: When connecting a new carrier account to ShipHero, double check your 3PL Clients' Settings to ensure you are connecting the carrier account to the correct ShipHero account; if Use Customer's Shipping Accounts is enabled the carrier account must be connected at the child account level, if Use Customer's Shipping Account is not enabled, the carrier account needs to be enabled at the 3PL level. More information about Managing 3PL Client Settings can be found here.