UPS Integration
Connect your UPS account to access UPS rates, label generation, and tracking.
Setting Up the Integration
Prerequisites
Before connecting UPS, make sure you have:
- A UPS account that can create shipments
- Your UPS shipping account number
- Admin access to your Cybership team
- A complete billing address on your Cybership team
For US and Puerto Rico accounts, UPS commonly uses a 6-character shipper number. Other accounts may use a 10-digit account number.
Verify Your UPS Account Number
To verify your UPS account number is linked to your team:
- Log in to UPS.com using your credentials.
- Open your user menu in the top right.
- Select Accounts and Payment.
- Verify that your active UPS account number is listed.
- If it is not listed, select Add a Payment Method and follow the prompts to link it.
Please consult UPS to determine whether a single account number supports multiple origins. This is especially critical for international locations, because carrier operations vary by country.
Installing the Integration
-
Navigate to Integrations
- Open ShipOS → Settings → Integrations (opens the Cybership dashboard in a new tab)
- Click Add Integration and select UPS
-
Enter Account Number
- Enter your UPS shipping account number
- Click Connect UPS Account
-
Authorize with UPS
- Sign in to UPS when prompted
- Review the requested permissions
- Approve access for Cybership
-
Complete Setup
- UPS redirects you back to Cybership
- Cybership validates the UPS account number
- The UPS integration becomes available for rate shopping and labels
-
Configure UPS Options (Optional)
- Open the connected UPS integration's settings menu and select Configure UPS
- Select the pickup type configured for the account: daily pickup, occasional pickup, or customer counter
- Set the pickup cutoff to the UPS pickup time in your team's timezone
- Optionally enable UPS Carbon Neutral Shipping; UPS adds a fee to purchase carbon offset credits
Supported Services
The integration supports common UPS domestic services:
| Service | Description |
|---|---|
| UPS Ground | Standard ground delivery |
| UPS 3 Day Select | Three-business-day delivery |
| UPS 2nd Day Air | Two-business-day air delivery |
| UPS 2nd Day Air A.M. | Morning two-business-day delivery |
| UPS Next Day Air | Next-business-day air delivery |
| UPS Next Day Air Saver | Next-business-day saver delivery |
Pricing and Rate Shopping
Pricing Tiers
The integration requests rates for your connected UPS account:
| Pricing Tier | Description |
|---|---|
| Account Rates | Rates returned by UPS for the connected account |
| Negotiated Rates | Contract or discounted rates returned by UPS for your account |
When UPS returns negotiated rates for your account, Cybership uses those rates in rate shopping.
Rate Calculation Factors
Rates are calculated based on:
| Factor | Description |
|---|---|
| Package dimensions/weight | Physical size and weight of the shipment |
| Origin/destination | Sender and recipient address details |
| UPS service | Selected service level |
| Account number | Connected UPS account used for account-based rates |
| Pickup type | Pickup arrangement configured for the UPS account |
| Pickup cutoff | Tender date and time calculated in the team's timezone |
| Saturday pickup | Optional Saturday tendering for eligible UPS accounts |
| Carbon-neutral shipping | Optional UPS carbon offset fee included in the rate |
| International details | Customs and shipment value details when required |
Label Generation
Domestic Labels
When creating domestic UPS labels, Cybership:
- Uses the selected UPS service from rate shopping
- Sends the shipment and package details to UPS, including the same calculated tender date used for rating
- Purchases the UPS label for the connected account
- Stores the generated label for download and fulfillment workflows
- Saves tracking details on the shipment
International Labels
International UPS shipments may require:
- Complete sender and recipient addresses
- Package weight and dimensions
- Customs item details
- Shipment value and currency
- A UPS service that supports the destination country
Label Requirements
UPS may reject labels when account, address, package, or customs information is incomplete. Review the error message and update the shipment details before trying again.
Tracking and Updates
Real-time Tracking
UPS tracking is available for labels generated through the integration. Tracking details help keep shipment status visible in Cybership as packages move through the UPS network.
Tracking Event Categories
| UPS Status | Cybership Status | Description |
|---|---|---|
| Label Created | Pre-Transit | Label created, awaiting package |
| In Transit | In Transit | Package is moving through UPS |
| Out for Delivery | Out for Delivery | Package is on vehicle for delivery |
| Delivered | Delivered | Package was delivered successfully |
| Exception | Delivery Exception | UPS reported an issue with delivery |
Advanced Features
Account Number Validation
During setup, Cybership validates the UPS account number before activating the integration.
Pickup Type
Cybership sends the selected pickup arrangement to UPS during rate shopping. Choose the option that matches the account: daily pickup, occasional pickup, or customer counter.
UPS Pickup Cutoff
Set the cutoff to your UPS pickup time. Cybership evaluates it in the timezone configured for your team:
- Before the cutoff on a configured pickup day, UPS rating and label creation use that calendar date and the configured cutoff time.
- At or after the cutoff, they use the next configured pickup day.
- Saturday is a pickup day only when Saturday pickup is enabled. When configured, the regular pickup cutoff applies on Saturday.
- Sunday is never treated as a pickup day.
- The same calculated tender date is sent to UPS for rate shopping and label creation, even when the cutoff is crossed while the label request is running.
Saturday pickup can be enabled independently of the cutoff. Clearing the cutoff disables rollover calculation and preserves the integration's legacy tender-date behavior. The setting does not change an order's Required Ship Date.
UPS Carbon Neutral Shipping
When enabled, Cybership requests UPS carbon-neutral shipping in rate and label requests. UPS adds a fee to purchase carbon offset credits for the shipment.
Address Handling
The integration formats shipment addresses for UPS rate and label requests. Complete address fields are required for reliable rate shopping and label generation.
Connection Management
Cybership manages the UPS account connection after authorization. If UPS requires renewed access, reconnect the UPS integration from integration settings.
Frequently Asked Questions
Troubleshooting
Common Issues
If UPS connection fails, confirm the account number is correct, the account is active in UPS, and your Cybership team billing address is complete.
Connection Issues
If connection fails:
-
Verify Account Number
- Confirm the UPS account number is active
- Check Accounts and Payment in UPS.com
- Link the account number in UPS if it is missing
-
Authorization Errors
- Sign in with the UPS user that owns or can access the account
- Approve access when UPS prompts for authorization
- Try reconnecting if the browser session expired
-
Team Address Issues
- Confirm your Cybership team billing address is complete
- Verify country, postal code, and state/province fields
- Update missing address details before reconnecting
Rate Shopping Issues
If UPS does not return rates:
- Confirm the UPS integration is active
- Check that the ship-from and ship-to addresses are complete
- Confirm package weight and dimensions are valid
- Try a different UPS service or address pair
Label Generation Issues
Common problems and solutions:
- Service unavailable: Confirm the selected UPS service supports the destination
- Invalid address: Check the recipient address for missing fields
- Invalid package: Verify package dimensions and weight
- Authorization required: Reconnect UPS if the integration asks for authorization again
Getting Help
If you encounter issues not covered in this documentation:
- Check your UPS account status at UPS.com
- Verify the account number is linked under Accounts and Payment
- Review the Cybership error message for the specific requirement
- Contact Cybership support with the error message, team, and integration details