--- title: Copper API Integration on Truto slug: copper category: CRM canonical: "https://truto.one/integrations/detail/copper/" --- # Copper API Integration on Truto **Category:** CRM **Status:** Generally available ## Unified APIs ### Unified CRM API - **Accounts** — The accounts represent a company in a CRM. - **Contacts** — The contacts represent an existing point of contact at a company in a CRM. - **Engagements** — The engagements represent an interaction noted in a CRM. - **Leads** — The leads represent a potential customer in a CRM. - **Notes** — The notes represent a note on another object in a CRM. - **Opportunities** — The opportunities represent an opportunity in a CRM. - **Stages** — The stages represent a stage of an opportunity in a CRM. - **Tasks** — The tasks represent a task in a CRM. ### Unified User Directory API - **Users** — The User object represents a User. ## How it works 1. **Link your customer's Copper account.** Use Truto's frontend SDK; we handle every OAuth and API key flow so you don't need to create the OAuth app. 2. **Authentication is automatic.** Truto refreshes tokens, stores credentials securely, and injects them into every API request. 3. **Call Truto's API to reach Copper.** The Proxy API is a 1-to-1 mapping of the Copper API. 4. **Get a unified response format.** Every response uses a single shape, with cursor-based pagination and data in the `result` field. ## Use cases - **Log external communication channels into Copper automatically** — Copper natively captures email and calendar activity, but SaaS tools handling calls, SMS, or video meetings need to push those interactions into Copper so reps see a complete activity timeline. A telephony or messaging platform can use Truto's Unified CRM API to create Engagements on Contact records, keeping Copper as the single source of truth. - **Trigger downstream workflows when deals change stage** — Proposal tools, billing platforms, and project management apps need to know the moment a Copper Opportunity moves to a stage like 'Closed Won.' By reading Opportunities and Stages through Truto, SaaS companies can react to pipeline changes and kick off their own workflows without building directly against Copper's API. - **Enrich and sync contact data bi-directionally** — Marketing automation and customer success platforms need to keep Contacts and Accounts in sync with Copper, updating custom fields like lead score or account health. Truto provides a consistent interface to read and write these records without managing Copper's specific API quirks around People and Companies. - **Push event attendees into Copper for sales follow-up** — Webinar and event platforms need to create or update Leads and Contacts in Copper after registrations and attendance, then log the interaction as an Engagement so reps see it in their Gmail sidebar. Truto's unified model lets event SaaS companies build this once across multiple CRMs including Copper. - **Surface sales context inside support and success tools** — Customer support platforms can pull Accounts, Opportunities, and ownership info from Copper to show agents whether a customer is mid-renewal or has open deals, then write Notes or Tasks back into Copper to alert the account owner about support issues. ## What you can build - **Automatic call and SMS logging** — Create Engagements on Copper Contact records after every call or message so reps see a unified activity feed alongside natively logged emails. - **One-click proposal generation from CRM data** — Pull Opportunities, linked Contacts, and Accounts from Copper to auto-fill proposal templates, then write a Note with the document link back to the Opportunity when signed. - **Pipeline stage change listener** — Read Opportunities and Stages to detect when deals move to key milestones like 'Contract Signed' or 'Closed Won' and trigger actions in your product. - **Contact and account enrichment sync** — Fetch Contacts and Accounts from Copper, enrich them with external data in your platform, and write updated fields back to keep both systems current. - **Owner-aware task and note creation** — Use the Unified User Directory API to resolve Copper user IDs, then create Tasks or Notes assigned to the correct Account or Opportunity owner. - **Lead creation from external signals** — Automatically create Leads in Copper when prospects take action in your product — event registration, form submission, or inbound chat — so sales teams can follow up immediately. ## FAQs ### What authentication method does Copper use? Copper's API uses API key authentication tied to a specific user's email address. Truto handles storing and passing these credentials so your end users authenticate once and you never manage tokens directly. ### How does Copper's terminology map to Truto's Unified CRM API? Copper People map to Contacts, Companies map to Accounts, Opportunities map directly, and Activities map to Engagements. Truto's unified model abstracts these naming differences so you work with a consistent schema across CRMs. ### Which Unified APIs does Truto support for Copper? Truto supports the Unified CRM API (Accounts, Contacts, Engagements, Leads, Notes, Opportunities, Stages, Tasks) and the Unified User Directory API (Users) for Copper. Additional tools or proxy calls can be built on request if you need access to Copper-specific endpoints. ### Can I read and write custom fields on Copper records through Truto? Yes. Truto's Unified CRM API supports passing through custom fields on objects like Contacts, Accounts, and Opportunities. This is essential for Copper users who rely heavily on custom fields for filtering and segmentation. ### Does Truto handle Copper's API pagination and rate limits? Yes. Truto manages pagination and respects Copper's rate limits automatically, so you don't need to implement retry logic or cursor management in your integration code. ### What if I need a Copper endpoint that isn't covered by the Unified API? Truto builds additional tools on request. If you need access to Copper-specific features like webhook subscriptions, pipeline configuration, or tag management beyond what the Unified CRM API covers, reach out and the team can add support.