> ## Documentation Index
> Fetch the complete documentation index at: https://docs.runalloy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# UPS

> Integration details and setup guide for the UPS connector in Alloy Automation.

## Pre-Built Tooling

| Category                            | Details                     |
| ----------------------------------- | --------------------------- |
| **Authentication**                  | OAuth 2.0                   |
| **Two-Way Sync**                    | Yes                         |
| **Events Supported**                | Yes                         |
| **Realtime**                        | Yes (via Webhooks/Polling)  |
| **Supports Rate Limiting**          | Yes                         |
| **Authentication Scopes Supported** | Varies by integration needs |

***

## Objects Supported

Alloy Automation supports various objects from **UPS**. Refer to the connector's OpenAPI specification for the complete list of supported endpoints and data models.

***

## Set Up Guide

### Trial Access

| Question                                           | Answer                                                                                                       |
| -------------------------------------------------- | ------------------------------------------------------------------------------------------------------------ |
| **Offers free trial?**                             | Register for UPS Developer Kit for free. [Register for developer kit](https://developer.ups.com/get-started) |
| **Requires paid sandbox**                          | Varies. Check UPS documentation.                                                                             |
| **Requires partnership to obtain authentication?** | No for most cases. Check UPS developer portal for details.                                                   |

***

### Authentication

<step>
  ## Step 1: Create UPS Account

  1. Visit **UPS** ([https://www.ups.com/upsdeveloperkit](https://www.ups.com/upsdeveloperkit))
  2. Sign up for an account or start a free trial
  3. Complete the onboarding process
  4. Verify your email if required
</step>

<step>
  ## Step 2: Generate API Credentials

  1. Log into your UPS account
  2. Navigate to Settings or Developer/API section
  3. Create or generate API credentials (API keys, OAuth app, etc.)
  4. Copy your credentials securely
  5. Note any required configuration (scopes, permissions, etc.)
</step>

<step>
  ## Step 3: Configure Alloy Automation

  1. In Alloy Automation, configure your UPS connector
  2. Provide the required authentication credentials
  3. For OAuth: Provide Client ID and Client Secret
  4. For API Key: Provide the API key or token
  5. Test the connection by performing a sample API call
</step>

***

## Use Cases

### 1) Data synchronization

Sync data between UPS and other business systems to maintain consistency across platforms.

### 2) Workflow automation

Trigger automated workflows based on events in UPS, enabling seamless business process automation.

### 3) Real-time notifications

Send real-time notifications or updates to other systems when changes occur in UPS.

### 4) Reporting and analytics

Extract data from UPS for custom reporting, dashboards, or integration with business intelligence tools.

### 5) Multi-platform integration

Connect UPS with CRM, e-commerce, marketing, or ERP systems for comprehensive business operations.

***

## API Gotchas

* **Rate Limiting:** UPS enforces API rate limits. Monitor for 429 status codes and implement exponential backoff to handle rate limit errors gracefully.

* **Authentication Tokens:** Securely store and manage authentication tokens. Implement token refresh logic for OAuth-based integrations to maintain continuous access.

* **Data Format Requirements:** Pay attention to required fields, data types, and format constraints when creating or updating records in UPS.

> For questions or troubleshooting, contact **[support@runalloy.com](mailto:support@runalloy.com)**.