How to Get UPS API Credentials for Spirit Sale

How to Get UPS API Credentials for Spirit Sale

Overview

To use UPS shipping rates in Spirit Sale, you must create API credentials through UPS.

You will generate:

  • UPS Client ID

  • UPS Client Secret

These credentials are required to connect your UPS account and display shipping rates at checkout.

Info
Note: These credentials are used only for live rate calculations. Spirit Sale does not directly create UPS labels. You can print labels using Shippo or ShipStation integrations or through UPS.com or any other shipping platform you prefer.

Before You Begin

You will need:

  • A valid UPS account number

  • Access to your UPS account login

Important:

  • You must create Production credentials, not Sandbox/Test credentials

  • The Rating API must be enabled for shipping rates to work


Important Security Information

Your UPS API credentials are sensitive and should be kept secure.

  • Do not share your Client ID or Client Secret publicly

  • Do not send credentials over unsecured channels

  • Only enter credentials directly into trusted systems such as Spirit Sale

Alert

For security reasons, Spirit Sale Support is unable to create or manage UPS API credentials on your behalf. These must be generated and maintained within your UPS account.


Step 1: Go to the UPS Developer Portal

Go to:
https://developer.ups.com/

Sign in using your UPS account.

If you do not have a login, create one using your UPS account information.


Step 2: Create a New App

Once logged in:

  1. Navigate to your dashboard

  2. Click Create App

  3. Enter the required details

Suggested values:

  • App Name: Spirit Sale Integration

  • Purpose: Shipping / E-commerce

Continue through the prompts to create the application.


Step 3: Request API Access

During setup or after app creation, you will be prompted to request access to UPS APIs.

Make sure to request access to:

  • Rating (Required)

  • Shipping (Recommended)

  • Tracking (Optional)

  • Address Validation (Optional)

  • Authorization (OAuth)

Important:

  • The Rating API is required for UPS shipping rates to appear at checkout

  • Some APIs may require approval from UPS before they become active



You may be asked to link your UPS account number to the application.

This ensures:

  • Rates are tied to your account

  • Shipping charges are calculated correctly

UPS may require additional verification such as billing or account details.


Step 5: Locate Your Credentials

After your app is created and approved:

Locate and copy your:

  • Client ID

  • Client Secret



Step 6: Confirm Your App is Active

Before leaving the UPS portal, confirm:

  • Your app status is Active

  • The Rating API is enabled and approved

If approval is still pending, UPS rates may not appear yet in Spirit Sale.


Step 7: Enter Your Credentials in Spirit Sale

Once you have your Client ID and Client Secret:

  1. Go to:
    Settings → Shipping Methods → UPS

  2. Enter your:

    • UPS CLIENT ID

    • UPS CLIENT SECRET

  3. Click:
    Update

After saving, your UPS shipping rates should be available at checkout.





Common Issues

Rates Not Showing at Checkout

This is usually caused by:

  • Rating API not enabled

  • App not approved yet

  • UPS account not linked properly

Cannot Access Production Credentials

If you are unable to activate production access, you may need to contact UPS to complete account verification.

    • Related Articles

    • Updating UPS Credentials to OAuth 2.0 in Spirit Sale

      Who This Applies To This update only applies to stores currently using legacy UPS credentials (Access Key authentication). If your store is already using UPS OAuth credentials (Client ID and Client Secret), no action is required. Important Notice UPS ...

    • Updating Your USPS Credentials in Spirit Sale (Migration to New USPS APIs)

      Who Does This Apply To This information only applies to Spirit Sale stores still using the older USPS Web Tools (Legacy) API for live shipping rates. You do NOT need to follow this guide if: You don't use USPS for shipping. You already migrated to ...

    • How to Create USPS API Credentials

      Overview This article walks you through the steps for creating USPS API credentials using the USPS Developer Portal↗. These credentials allow your your Spirit Sale stores to securely access USPS APIs for services such live shipping rates. Steps to ...

    • How to Set Up Your Stripe API Keys With Spirit Sale

      Overview Spirit Sale integrates directly with Stripe to process payments. To connect your store, you’ll need your live publishable key and live secret key from Stripe. Important Notes: Only standard live keys are supported. Restricted keys will not ...

    • USPS Shipping Rates Not Showing or Intermittent at Checkout

      If USPS shipping rates are not appearing at checkout, appear inconsistent, or occasionally fail to load, this is typically related to how the United States Postal Service (USPS) API handles request limits. Why This Happens USPS provides real-time ...