--- title: Kommo API Integration on Truto slug: kommo category: CRM canonical: "https://truto.one/integrations/detail/kommo/" --- # Kommo API Integration on Truto **Category:** CRM **Status:** Generally available ## Unified APIs ### Unified User Directory API - **Roles** — The Role object represents a role of a User. - **Users** — The User object represents a User. ## How it works 1. **Link your customer's Kommo 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 Kommo.** The Proxy API is a 1-to-1 mapping of the Kommo 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 - **Sync Kommo users and roles into your SaaS platform** — If your product needs to map permissions, assign ownership, or display team structures, you can pull Kommo users and their roles via Truto's Unified User Directory API — no need to handle Kommo's auth or pagination yourself. - **Inject AI call summaries into Kommo's lead timeline** — Voice AI and telephony SaaS companies can push call transcripts, recordings, and follow-up tasks directly into Kommo leads so sales reps see everything in their unified chat stream without switching tools. - **Automate pipeline progression from external deal events** — E-signature, billing, or CPQ platforms can listen for events in their own system (e.g., contract signed, invoice paid) and update the corresponding Kommo lead's pipeline stage, keeping reps' boards accurate in real time. - **Push marketing leads into Kommo pipelines automatically** — Marketing automation and lead-gen SaaS companies can create new Kommo leads and contacts from form submissions, webinar signups, or abandoned carts — ensuring no inbound prospect falls through the cracks in a messenger-first sales workflow. - **Enrich Kommo contacts with external data** — Data enrichment or analytics SaaS platforms can look up existing Kommo contacts, append custom field values like risk scores or LTV, and keep the CRM current without manual data entry by the sales team. ## What you can build - **Team roster sync with role-based access mapping** — Import Kommo users and roles via the Unified User Directory API to mirror team structures and assign ownership inside your product. - **One-click Kommo account connection for end users** — Let your customers securely connect their Kommo accounts through Truto's managed OAuth flow, eliminating the need to build and maintain auth infrastructure yourself. - **Real-time timeline injection for call or chat logs** — Push structured notes — call transcripts, AI summaries, document links — directly into a Kommo lead's timeline so reps never lose context. - **Automated lead creation and contact linking** — Create new Kommo leads tied to existing or new contacts whenever an event fires in your product, such as a form fill, abandoned cart, or inbound call. - **Pipeline stage updater triggered by external workflows** — Move Kommo deals to the correct pipeline column automatically when a contract is signed, a payment clears, or any external milestone completes. - **Custom field writer for enrichment and scoring** — Write computed values — lead scores, LTV estimates, sentiment tags — back into Kommo custom fields so sales reps can prioritize directly from their pipeline view. ## FAQs ### What Unified APIs does Truto currently support for Kommo? Truto supports the Unified User Directory API for Kommo, covering Users and Roles. Additional tools and unified API resources (e.g., Leads, Contacts, Notes, Pipelines) are built on request — reach out to the Truto team to discuss your specific use case. ### How does authentication work for Kommo integrations through Truto? Kommo uses OAuth 2.0 for API access. Truto manages the full OAuth flow — token exchange, storage, and refresh — so your end users simply authorize their Kommo account and you never handle raw credentials. ### Does Kommo impose API rate limits, and how does Truto handle them? Yes, Kommo's v4 API enforces rate limits (typically 7 requests per second per account). Truto handles retry logic and throttling transparently so your integration stays within limits without custom backoff code. ### Can I access Kommo leads, contacts, notes, and pipelines through Truto? These endpoints are available in Kommo's v4 REST API and Truto can build proxy or unified access to them on request. Currently, the Unified User Directory API (Users and Roles) is available out of the box. ### Does Kommo support custom fields, and can I read or write them? Yes, Kommo supports custom fields on Leads, Contacts, and Companies. Through Truto's on-request tooling, you can read and write custom field values — useful for injecting enrichment data like scores or tags directly into the CRM. ### How fresh is the data when reading from Kommo via Truto? Truto calls Kommo's API in real time by default, so data freshness matches what's in the Kommo account at the moment of the request. For high-frequency reads, Truto can also support caching strategies to stay within rate limits.