> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://cfs.crisp.help/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# How to Obtain and Set Up UPS API Credentials in ShipBoss


### Setting Up UPS API Credentials for Shipping

#### Step 1: Access the UPS Developer Portal
1. Go to [UPS Developer Portal](https://developer.ups.com).
2. Log in with your UPS account credentials.

#### Step 2: Navigate to the Apps Section
1. Once logged in, locate and click on the **"Apps"** or **"My Apps"** section.
2. ⚠️ *Note:* If you encounter issues using Google Chrome, try using Firefox for better compatibility.

#### Step 3: Create a New App
1. In the Apps section, click on **"Add Apps >"** to create a new application.
2. Complete the form with the following details:
   - **"I need API credentials because"** - Select **"I want to integrate UPS technology into my business."**
   - **Account Association** - Select your UPS shipper account number.
   - **API Access Agreement** - Check the box to agree.
3. Click **Continue** to proceed.

#### Step 4: Enter App Details
1. On the **App Details** screen, fill out the following:
   - **App Name**: Choose a name for your integration (e.g., "My Shipping App").
   - **Callback URL**: Enter `https://ship.shipboss.io`
   - **Billing Account Number**: Should be pre-populated with your UPS account number.
2. Add the following approved API services:
   - **Rating**
   - **Pickup**
   - **Quantum View**
   - **Address Validation**
   - **Paperless Documents**
   - **Authorization (OAuth)**
   - **Tracking**
   - **Shipping**
   - **Time In Transit**
   - **URL**: Enter `https://ship.shipboss.io`.
3. ⚠️ *Note:* If using your UPS account with a third-party application for the first time, email your UPS rep: “Please turn on negotiated rates over API for account XXXX.” This ensures correct rate display.

#### Step 5: Obtain API Credentials
1. After setup, view your **App Info/Credentials** page.
2. Copy your **Client ID** and **Client Secret** using the clipboard icons.

#### Step 6: Input Credentials in ShipBoss
1. Open **ShipBoss** and go to the **Admin** screen.
2. Navigate to the **Meters** tab and click **"Create Personal Meter."**
3. Select UPS as the carrier.
4. Enter:
   - **Title**: Name your app.
   - **Billing Account Number**
   - **Client ID** and **Client Secret** (paste from UPS Developer Portal).
5. Click **Save** to complete setup.
