UPS icon

UPS

Track shipments, validate addresses, rate, and create UPS shipments

Actions4

Shipping → Create

AI-generated

Summary

Create a UPS shipment using provided shipper, recipient, and package details, then receive a tracking number and a shipment label (including customs invoice for international shipments).

Inputs

  • Account Number — UPS account number that ships and is billed for the shipment; must be provided or supplied by an attached UPS Shipper Profile credential.
  • Service (required) — UPS shipping service code (e.g., Ground, Next Day Air); availability depends on origin-destination and account.
  • Shipper Name — Shipper contact or company name.
  • Shipper Address Line 1 — First line of the shipper's address.
  • Shipper Address Line 2 — Second line of the shipper's address (optional).
  • Shipper City — City of the shipper's address.
  • Shipper State / Province Code — State or province code of the shipper's address (e.g., NY).
  • Shipper Postal Code — Postal or ZIP code of the shipper's address.
  • Shipper Country Code — Country code of the shipper's address (default US).
  • Shipper Phone — Phone number for the shipper; may be required for cross-border shipments.
  • Use a Different Ship-From Address — Option to specify a different physical origin address than the shipper's.
  • Ship From Name — Contact or company name for the Ship From address if different.
  • Ship From Address Line 1 — First line of the Ship From address; if blank, falls back to the shipper's address line 1.
  • Ship From Address Line 2 — Second line of the Ship From address (optional).
  • Ship From City — City of the Ship From address.
  • Ship From State / Province Code — State or province code of the Ship From address.
  • Ship From Postal Code — Postal code of the Ship From address.
  • Ship From Country Code — Country code of the Ship From address (default US).
  • Ship To Name — Recipient contact or company name.
  • Ship To Address Line 1 (required) — First line of the recipient's address.
  • Ship To Address Line 2 — Second line of the recipient's address (optional).
  • Ship To City — City of the recipient's address.
  • Ship To State / Province Code — State or province code of the recipient's address.
  • Ship To Postal Code — Postal or ZIP code of the recipient's address.
  • Ship To Country Code — Country code of the recipient's address (default US).
  • Ship To Phone — Recipient phone number; may be required for cross-border shipments.
  • Ship To Is Residential — Indicates if recipient address is residential.
  • Weight (required) — Package weight.
  • Weight Unit — Unit of weight (Pounds or Kilograms).
  • Dimensions — Optional package dimensions (length, width, height).
  • Dimension Unit — Unit for dimensions (inches or centimeters).
  • Label Format — Format of the shipment label (GIF, ZPL, EPL, SPL).
  • Is International Shipment — Flag indicating if shipment is cross-border (origin and destination countries differ).
  • Customs Currency — Currency used for international shipment invoice (ISO 4217 code).
  • Invoice Date — Commercial invoice date for international shipments in yyyyMMdd format; defaults to today (UTC) if blank.
  • Invoice Number — Commercial invoice number for international shipments (optional).
  • Reason For Export — Reason for export on the commercial invoice for international shipments (e.g., SALE, GIFT).
  • Terms Of Shipment — Incoterms applied to the shipment (default DDU).
  • Sold To Name — Name of the party the goods are sold to for international shipments.
  • Sold To Address Line 1 — First line of Sold To address for international shipments.
  • Sold To Address Line 2 — Second line of Sold To address (optional).
  • Sold To City — City in Sold To address.
  • Sold To State / Province Code — State or province code in Sold To address.
  • Sold To Postal Code — Postal code of Sold To address.
  • Sold To Country Code — Country code of Sold To address (default US).
  • Commodities — At least one customs commodity line is required for international shipments, each with description, quantity, unit value, unit of measure, and optional commodity code and origin country.

Output shape

A single record containing the shipment ID, tracking numbers, charges, and flags for international shipment; optionally includes binary data for the shipment label and customs invoice PDFs.

Includes alerts on error. Binary outputs include the shipment label (GIF, ZPL, EPL, or SPL format) and, if international, customs invoice forms as PDFs. Requires a UPS account number through direct input or a Shipper Profile credential. Throws errors if international shipment lacks required customs commodities.

Links

Discussion