> ## 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.

# Copper

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

## Pre-Built Tooling

| Category                            | Details                                                 |
| ----------------------------------- | ------------------------------------------------------- |
| **Authentication**                  | API Key (Header: X-PW-AccessToken)                      |
| **Two-Way Sync**                    | Yes                                                     |
| **Events Supported**                | Yes (Webhooks)                                          |
| **Realtime**                        | Yes                                                     |
| **Supports Rate Limiting**          | Yes (180 requests per minute per user)                  |
| **Authentication Scopes Supported** | N/A (API key provides access based on user permissions) |

***

## Objects Supported

Alloy Automation supports syncing the following objects from **Copper**:

* **Leads**
* **People** (Contacts)
* **Companies**
* **Opportunities**
* **Tasks**
* **Activities**
* **Projects**
* **Pipelines** and **Pipeline Stages**
* **Custom Fields**
* **Tags**
* **Webhooks**
* **Related Items** (Entity relationships)

***

## Set Up Guide

### Trial Access

| Question                                           | Answer                                                                                               |
| -------------------------------------------------- | ---------------------------------------------------------------------------------------------------- |
| **Offers free trial?**                             | Yes. Copper offers a 14-day free trial. Sign up at [https://www.copper.com](https://www.copper.com). |
| **Requires requires paid sandbox**                 | No paid sandbox required. You can test with your trial account.                                      |
| **Requires partnership to obtain authentication?** | No. API keys are available directly from your Copper account settings.                               |

***

### Authentication (API Key)

Copper uses API Key authentication via the `X-PW-AccessToken` header, along with a user email header.

#### Generate your Copper API Key

1. Log in to your **Copper account**.
2. Click on **Settings** (gear icon) in the top-right corner.
3. Navigate to **Integrations** → **API Keys**.
4. Click **Generate** to create a new API key.
5. Copy the generated API key.
6. Enter your **API Key** and **User Email** into Alloy Automation.

#### Required Headers

* `X-PW-AccessToken`: Your API key
* `X-PW-UserEmail`: The email address of the API key owner
* `X-PW-Application`: Always set to `developer_api`

#### API Documentation

For detailed API documentation, visit: [https://developer.copper.com](https://developer.copper.com)

***

## Use Cases

### 1) CRM data synchronization

Sync leads, contacts, companies, and opportunities between Copper and other business systems, ensuring consistent customer data across your entire tech stack without manual data entry.

### 2) Lead routing and assignment

Automatically create or update leads in Copper based on form submissions, marketing campaigns, or sales activities, and route them to the appropriate sales representatives using custom assignment logic.

### 3) Opportunity pipeline tracking

Pull opportunity data, pipeline stages, and deal values from Copper into your business intelligence tools for comprehensive sales forecasting, pipeline analysis, and revenue tracking.

### 4) Task and activity management

Synchronize tasks and activities between Copper and your project management or productivity tools, ensuring sales teams stay organized and follow-up activities are tracked across systems.

### 5) Relationship mapping

Leverage Copper's related items functionality to maintain and sync complex entity relationships (people to companies, opportunities to contacts) across your integrated systems for complete relationship visibility.

***

## API Gotchas

* ⚠️ **Rate limiting:** Copper enforces a rate limit of 180 requests per minute per user. Requests exceeding this limit will return a 429 status code. Implement exponential backoff and request throttling.
* ⚠️ **Custom fields:** Custom field IDs and structures vary between Copper accounts. Use the field layouts endpoint to discover available custom fields before attempting to read or write custom field data.
* ⚠️ **Lead conversion:** When converting a lead to a person, the lead record is archived and cannot be modified afterward. Ensure all necessary lead data is captured before conversion.
* ⚠️ **Webhook limit:** Copper allows a maximum of 100 active webhook subscriptions per account. Plan your webhook strategy accordingly to stay within this limit.

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