Setting up your UPS Account

Requirements

In order to add UPS as a carrier in EasyPost, you need to already have an account established with UPS. You can sign up for a UPS account here.

The details necessary to add your UPS account will vary depending on the age of your account.

Account < 30 days old

You need the following company Information:

• Name
• Email
• Phone
• Company Name
• Company Website
• Job Title

Address Information

• Street1
• Street2
• City
• State
• Postal Code
• Country
• UPS Account/Shipper Number

Account > than 30 days old (in addition to the above details)

Invoice Information:

• Invoice Number
• Invoice Date
• Invoice Amount
• Invoice Currency
• Invoice Control ID

Finding Your Credentials

UPS Account Number

To find your UPS Account Number, you’ll need to login to your UPS account and navigate to Profile > Payment Options.

If there is no UPS Account Number then you will need to create one. You can do this by utilizing the “Add a Payment Method” dropdown and selecting “Add New Account”. Complete the required information and a new account will be created. 

UPS Account Address

Use the Location Address that was determined at the time you added the account. You can view your UPS account addresses. To find your addresses, you’ll need to login to your UPS account and navigate to Profile > Addresses.

If none of those addresses seem to be working, you can navigate back to Profile > Payment Options and edit your shipper account in order to access your Location Address to confirm which address you should be using.

UPS Invoice Details

If your account is older than 30 days, then you will need to provide invoice details to register your account within EasyPost.

• The Invoice Number, Date, Control ID, and Account Number can be located in the top right corner of the invoice.
• The Amount Due can be found in the bottom right corner of the invoice.

Register a UPS Account via API (for developers)

via cURL:

With Invoice data included:

curl -X POST https://api.easypost.com/v2/carrier_accounts/register \
-u PRODUCTION_API_KEY: \
-d 'carrier_account[type]=UpsAccount' \
-d 'carrier_account[description]=UPS Account Account' \
-d 'carrier_account[reference]=UPS Reference' \
-d 'carrier_account[registration_data][account_number]=ACCOUNT_NUMBER' \
-d 'carrier_account[registration_data][city]=CITY' \
-d 'carrier_account[registration_data][company]=COMPANY' \
-d 'carrier_account[registration_data][country]=COUNTRY' \
-d 'carrier_account[registration_data][email]=EMAIL' \
-d 'carrier_account[registration_data][name]=NAME' \
-d 'carrier_account[registration_data][phone]=PHONE' \
-d 'carrier_account[registration_data][postal_code]=POSTAL_CODE' \
-d 'carrier_account[registration_data][state]=STATE' \
-d 'carrier_account[registration_data][street1]=STREET1' \
-d 'carrier_account[registration_data][title]=TITLE' \
-d 'carrier_account[registration_data][website]=WEBSITE' \
-d 'carrier_account[registration_data][invoice_amount]=INVOICE_AMOUNT' \
-d 'carrier_account[registration_data][invoice_control_id]=INVOICE_CONTROL_ID' \
-d 'carrier_account[registration_data][invoice_currency]=INVOICE_CURRENCY' \
-d 'carrier_account[registration_data][invoice_date]=INVOICE_DATE' \
-d 'carrier_account[registration_data][invoice_number]=INVOICE_NUMBER'

curl -X POST https://api.easypost.com/v2/carrier_accounts/register \
-u PRODUCTION_API_KEY: \
-d 'carrier_account[type]=UpsAccount' \
-d 'carrier_account[description]=UPS Account Account' \
-d 'carrier_account[reference]=UPS Reference' \
-d 'carrier_account[registration_data][account_number]=ACCOUNT_NUMBER' \
-d 'carrier_account[registration_data][city]=CITY' \
-d 'carrier_account[registration_data][company]=COMPANY' \
-d 'carrier_account[registration_data][country]=COUNTRY' \
-d 'carrier_account[registration_data][email]=EMAIL' \
-d 'carrier_account[registration_data][name]=NAME' \
-d 'carrier_account[registration_data][phone]=PHONE' \
-d 'carrier_account[registration_data][postal_code]=POSTAL_CODE' \
-d 'carrier_account[registration_data][state]=STATE' \
-d 'carrier_account[registration_data][street1]=STREET1' \
-d 'carrier_account[registration_data][title]=TITLE' \
-d 'carrier_account[registration_data][website]=WEBSITE'