How to connect UPS V2


  1. Before you start

  2. Connection steps

  3. Additional Options

  4. International shipments

  5. Errors & Troubleshooting


1. Before you start

Starting from June 2023, to connect to UPS, you no longer need the UPS user ID, password, and Access Key, but only the account number associated with your UPS contract. However, you will still need the credentials you use to access the UPS portal, as they will be required in one step of the connection. If you already have them, you can proceed with the courier connection!


In case you insert your credentials and you don't get re-routed back to ShippyPro, check if you have a Campus Ship account.

UPS Campus Ship account can only be used to access the Campus Ship application, it cannot be connected to ShippyPro.

2. Connection steps

Learn how to connect UPS and start shipping right away.

  1. Click on Carriers > Connection and click on the UPS logo.

  2. You will be redirected to the UPS portal where you will need to log in with your account credentials.

  3. Once logged in, you will need to accept the UPS terms and conditions, which authorize ShippyPro to connect with the courier.

  4. After completing this step, you will be redirected to ShippyPro where you will need to enter your account number.

  5. You can sometimes find it referred to as the Shipper Number on paper or electronic invoices for registered senders at the UPS Billing Center. Alternatively, you can search for the tracking number of a package that was shipped using your UPS account. Look for the six-digit alphanumeric string immediately following "1Z" – that is your Account Number.

  6. Connect your preferred label type by choosing between PDF and ZPL formats.


3. Additional options

Email notification

No email notification: UPS will not send any email.

Receiver Return notification: UPS will inform the receiver in case of return shipments.

QV notifications: UPS will send the email to the sender only

Request Commercial Invoice

Flag this option, if you want to create a paper commercial invoice from UPS to attach to your international shipments.

Use your company info as the default shipper

Enable this option to set your company as the default sender.

Add freight charges to commercial invoice

Select this option if you want to include the transportation cost within commercial invoices.

Test Mode

Enable test mode to make test shipments if you have already requested test credentials from your UPS account manager.


Can I use UPS to ship to a P.O. Box?

Unfortunately, UPS only accepts shipments destined for a valid street address, so it does not deliver to P.O. Boxes. If a sender needs to ship to a P.O. Box, it is necessary to include the recipient's phone number on the label. Your package addressed to a P.O. Box may experience delays, will not be covered by any UPS service guarantee, and an address correction fee will be charged. In addition, the courier does not accept deliveries to Army Post Office (APO) and Fleet Post Office (FPO) addresses.

Validate UPS invoices

The process is not automatic, so you will need to do it manually.

To have your invoice number added to the invoice created together with the Label, you'll need to add it during Shipment Creation from To Ship section.

Proceed as usual till the Carrier selection step, then click on + Carriers Option > UPS INVOICE NUMBER and Save.


SurePost service

Sure Post is currently not available in the new version, but it will be delivered as soon as UPS will deliver it.


How do I add UPS Access Points via API?

To include UPS Drop Off Points to your shipments add the following tag inside the Params field in the Ship request:

This way it will be automatically assigned to your shipment without further actions.


Display EDI for UPS shipments

In order to display EDI inside your UPS labels you'd need to first ask your UPS person to activate the service on your contract, then you'll be required to make a specific registration inside UPS Portal.

Once done EDI will automatically displayed for your shipments!


4. International shipments

UPS v2

✅ supports the upload of ETDs from Invoice Manager;

✅ supports the upload of ETDs via API (UploadPaperless);

✅ supports the generation of UPS Commercial Invoice, also valid as ETD flagging:



5. Errors & Troubleshooting

Go to this link to check common errors and resolutions:

How to fix UPS errors