Skip to main content

​
Pre-Built Tooling

CategoryDetails
AuthenticationAPI Key (Header: X-PW-AccessToken)
Two-Way SyncYes
Events SupportedYes (Webhooks)
RealtimeYes
Supports Rate LimitingYes (180 requests per minute per user)
Authentication Scopes SupportedN/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

QuestionAnswer
Offers free trial?Yes. Copper offers a 14-day free trial. Sign up at https://www.copper.com.
Requires requires paid sandboxNo 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

​
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.
⌘I