Site Logo

🎉 ShipEngine is becoming ShipStation API 🎉

Over the next few months you'll notice the ShipEngine website, documentation portal, and dashboard being rebranded as ShipStation API. For our ShipEngine customers, you don't need to take any action or change any of your integrations in any way. All endpoints will remain the same and continue to function as they always have.

To learn more about what's coming, review our New ShipStation API page.

UPS from ShipEngine

UPS from ShipEngine offers domestic and international shipping services at pre-negotiated rates to ShipEngine accounts in the following countries:

  • US
  • Canada
  • UK
  • Australia
  • New Zealand
  • France
  • Germany

This guide provides developers the details needed to build UPS from ShipEngine shipping capabilities into your ShipEngine workflows.

ShipEngine also allows you to connect your own existing UPS account and the requirements and service details are different than those for UPS from ShipEngine. For details about connecting and using your own UPS account with ShipEngine, see our UPS Guide.

Requirements

carrier_name: ups_walleted

  • A ShipEngine account based in one of the supported countries.
  • ShipEngine Carriers must be activated for the account and have a positive account balance to create labels. See our Using ShipEngine Carriers page for details about activating in your account.
  • A weight value is required for all shipments.
  • Available services will vary by country. See the Service Details section for specifics.

Rates

UPS from ShipEngine supports rate shopping with ShipEngine.

Service Details

Available UPS from ShipEngine services are provided below. Please note that carriers may update their available services at any time. To ensure you are always using valid services, you can use the list carrier services endpoint at any time.

Domestic Services

ServiceTransit TimeService CodesCountries
UPS® Ground1-5 Business daysups_groundUS
UPS® Ground Saver3-7 Business daysups_ground_saverUS
UPS Standard1-5 Business daysups_standardCA, GB
UPS 3 Day Select®3 Business daysups_3_day_selectUS
UPS 2nd Day Air®2 Business daysups_2nd_day_airUS, CA
UPS 2nd Day Air AM®2 Business days (before noon)ups_2nd_day_air_amUS
UPS Next Day Air Saver®1 Business day (End of day)ups_next_day_air_saverUS, CA
UPS Next Day Air®1 Business dayups_next_day_airUS, CA
UPS Next Day Air® Early1 Business day (delivery between 8am-10am)ups_next_day_air_early_amUS, CA
UPS Express®ups_expressAU, DE, FR, GB, NZ
UPS Express Plus®ups_express_plusAU, DE, FR, GB, NZ
UPS Worldwide Saver®ups_worldwide_saverAU, DE, FR, GB, NZ

International Services

ServiceTransit TimeService CodesCountries
UPS Ground® (International)ups_ground_internationalUS
UPS 3 Day Select®3 Business daysups_3_day_selectCA
UPS Worldwide Express®Varies by countryups_worldwide_expressUS, CA, GB
UPS Worldwide Expedited®ups_worldwide_expeditedUS, CA, GB
UPS Worldwide Saver®ups_worldwide_saverUS, CA, GB
UPS Standard®ups_standardUS, CA, GB
UPS Worldwide Express Plus®ups_worldwide_express_plusUS, CA, GB

Return Services

You can use the following UPS from ShipEngine domestic services for returns:

  • UPS® Ground
  • UPS 3 Day Select®
  • UPS 2nd Day Air®
  • UPS Next Day Air Saver®
  • UPS Next Day Air®
  • UPS Next Day Air® Early
  • UPS 2nd Day Air AM®
  • UPS Express®
  • UPS Express Plus®
  • UPS Worldwide Saver®

Review the Return Shipping Labels page for details on creating return labels with ShipEngine.

Packages

UPS from ShipEngine does not specify carrier package types. You can use custom package types or the generic package package type.

Adding Shipment Insurance

UPS from ShipEngine does not support adding carrier insurance to shipments created in ShipEngine. US accounts can add Parcelguard protection to UPS from ShipEngine shipments.

Review the Parcel Insurance page for details about adding shipment insurance with ShipEngine.

Label Support

  • Label sizes: 4" x 6"
  • Label formats: PDF, PNG, ZPL

Label Reference Fields

UPS from ShipEngine supports adding custom label messages.

Multi-Package Labels

All UPS from ShipEngine services support creating multi-package labels.

See our Multi-Package Shipping page for details about creating multi-package labels.

Label Branding

UPS from ShipEngine does not support label branding.

Voiding Labels

UPS from ShipEngine supports voiding labels with ShipEngine. Labels must be voided within 30 days of the label create date and must not have been scanned by UPS.

See our Void a Label page for details about voiding labels with ShipEngine.

Paperless Lables

UPS from ShipEngine supports creating paperless labels.

See our Paperless Labels page for details about creating paperless labels with ShipEngine.

Customs Declarations

UPS from ShipEngine electronically submits customs declarations in a commercial invoice. The label will display "EDI" to indicate electronic submission. If you wish to print the commercial invoice, you can access it from the label response form_download object.

Delivery Confirmation

UPS from ShipEngine supports the following delivery confirmation options (options other than online may incur an additional fee from UPS).

Confirmation TypeAPI CodeDescription
OnlineonlineThis is the default option if no confirmation type is specified.
DeliverydeliveryDelivery confirmation requested.
SignaturesignatureSignature confirmation requested.
Adult signatureadult_signatureAdult signature confirmation requested.
VerbalverbalVerbal confirmation requested.

See our Delivery Confirmation page for more details about using the confirmation property.

Advanced Options

UPS from ShipEngine supports certain advanced options, which you can add to the shipment object when creating a shipment or label.

OptionTypeDefault ValueDescription
additional_handlingbooleannullIndicates the package requires special handling.
delivered_duty_paidbooleanfalseIndicates the shipment is DDP (that is, the shipper is paying the duties/taxes for the shipment rather than the recipient).
non_machinablebooleanfalseIndicates that the package cannot be processed through sorting machines.
saturday_deliverybooleanfalseIndicates that the carrier should charge for delivery on Saturday for services that do not otherwise include saturday delivery. Only valid for certain services.

To ensure you always have the most up-to-date information about a carrier's advanced options, use the list carrier options call.

Dangerous Goods

UPS from ShipEngine does not support shipping dangerous goods.

Manifests

UPS from ShipEngine does not support creating printable manifests. All shipment data is submitted electronically to UPS at the time of label creation, so UPS will have the shipment data in their system.

Scheduling Pickups

UPS from ShipEngine supports schedule carrier pickups. Using this option may incur additional fees.

Service Points (PUDO)

UPS from ShipEngine does not support shipping to service points.

Tracking

UPS from ShipEngine supports receiving tracking updates. Review our ​Track a Package guides​​ for details on tracking with the ShipEngine API.