{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-agen-for-work/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["Notification","LightboxImage"]},"type":"markdown"},"seo":{"title":"Zoho CRM integration","siteUrl":"https://developers.frontegg.com/","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"zoho-crm-integration","__idx":0},"children":["Zoho CRM integration"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Zoho CRM is a cloud-based sales and customer relationship management platform that helps teams manage leads, contacts, accounts, and deals. Integrating Zoho CRM with Frontegg allows your application to read and write CRM data — including leads, contacts, and deals — on behalf of your users through OAuth 2.0 authentication."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Notification","attributes":{"title":"Prerequisites","type":"attention"},"children":[{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A Zoho CRM account with admin access"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Access to the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://api-console.zoho.eu/"},"children":["Zoho API Console"]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"connect-zoho-crm","__idx":1},"children":["Connect Zoho CRM"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-1-sign-in-to-the-zoho-api-console","__idx":2},"children":["Step 1: Sign in to the Zoho API Console"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Navigate to ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://api-console.zoho.eu/"},"children":["api-console.zoho.eu"]}," and sign in with your Zoho account."]},{"$$mdtype":"Tag","name":"LightboxImage","attributes":{"isLightbox":true},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/zoho-crm-1.969280cf13bd4959f0005180df0c478e45e9f9c748fe08cd14aa888a3f5afba5.1ce25488.png","alt":"Zoho Accounts sign-in page"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-2-open-the-api-console","__idx":3},"children":["Step 2: Open the API Console"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After signing in, you will land on the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["API Console"]}," page, which lists all your existing OAuth applications. Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["ADD CLIENT"]}," in the top-right corner to create a new application."]},{"$$mdtype":"Tag","name":"LightboxImage","attributes":{"isLightbox":true},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/zoho-crm-2.e8189d7c225240b010e136ac96df46ded6fb4dacade9e39f4b77bddc0b2b7821.1ce25488.png","alt":"Zoho API Console with ADD CLIENT button"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-3-select-a-client-type","__idx":4},"children":["Step 3: Select a client type"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Choose a Client Type"]}," dialog, select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Server-based Applications"]},". This type is required for server-side OAuth flows used by the Frontegg integration."]},{"$$mdtype":"Tag","name":"LightboxImage","attributes":{"isLightbox":true},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/zoho-crm-3.c749d718e6f9215b0395dff935d9bffd57d53097901327e991977622de55a85d.1ce25488.png","alt":"Zoho client type selection with Server-based Applications highlighted"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-4-fill-in-the-application-details","__idx":5},"children":["Step 4: Fill in the application details"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["On the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Create New Client"]}," form, enter the following:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Client Name"]}," — Enter a name for your application, for example ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Frontegg Integration"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Homepage URL"]}," — Enter your application's homepage URL."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Authorized Redirect URIs"]}," — Enter the Frontegg redirect URI:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"https://YOUR_MCP_GATEWAY_URL/integration-callback\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["CREATE"]}," to continue."]},{"$$mdtype":"Tag","name":"LightboxImage","attributes":{"isLightbox":true},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/zoho-crm-4.5d27395fca3a4292cba53d3f2b71802fbf4be47bf29763c40f7e188532100019.1ce25488.png","alt":"Zoho CRM Create New Client form filled in"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-5-copy-your-credentials","__idx":6},"children":["Step 5: Copy your credentials"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After the app is created, Zoho opens the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Client Secret"]}," tab showing your credentials:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Client ID"]}," — Your app's unique identifier used to initiate OAuth flows."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Client Secret"]}," — Used to exchange authorization codes for access tokens. Keep this value secure."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Copy both values and store them securely."]},{"$$mdtype":"Tag","name":"Notification","attributes":{"title":"Keep your credentials secure","type":"attention"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Never share or commit your Client Secret to version control."]}]},{"$$mdtype":"Tag","name":"LightboxImage","attributes":{"isLightbox":true},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/zoho-crm-5.b28fa48dcb348909de3cc4afc5466d7dbc944a1d84d174865717fdfc7b520408.1ce25488.png","alt":"Zoho CRM app credentials with Client ID and Client Secret"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-6-add-redirect-uris","__idx":7},"children":["Step 6: Add redirect URIs"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Click the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Client Details"]}," tab. Under ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Authorized Redirect URIs"]},", confirm the Frontegg callback URL is present:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://YOUR_MCP_GATEWAY_URL/integration-callback"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["UPDATE"]}," to save."]},{"$$mdtype":"Tag","name":"LightboxImage","attributes":{"isLightbox":true},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/zoho-crm-6.7380035b00d91dec69d16ab60bf0f16316de4db8e84caff4cc8cf8ece3de6e43.1ce25488.png","alt":"Zoho CRM Client Details with the redirect URI configured"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-7-configure-oauth-scopes","__idx":8},"children":["Step 7: Configure OAuth scopes"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Zoho CRM scopes are requested at authorization time rather than configured in the API Console. When configuring the Frontegg integration, select the scopes your application requires:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Scope"},"children":["Scope"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ZohoCRM.modules.ALL"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Full access to all CRM modules"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ZohoCRM.modules.READ"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read access to CRM modules"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ZohoCRM.users.READ"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read user information"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ZohoCRM.settings.ALL"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Full access to CRM settings"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ZohoCRM.org.READ"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read organization information"]}]}]}]}]},{"$$mdtype":"Tag","name":"Notification","attributes":{"title":"Minimum required scopes","type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For basic CRM functionality, you need: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ZohoCRM.modules.READ"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ZohoCRM.users.READ"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"configure-the-frontegg-portal","__idx":9},"children":["Configure the Frontegg portal"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Once you have obtained your ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Client ID"]}," and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Client Secret"]}," from the steps above, enter them in the integration configuration page of the Frontegg portal:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Open the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Frontegg portal"]}," and navigate to [ENVIRONMENT] → Integrations → Zoho CRM."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Enter the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Client ID"]}," and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Client Secret"]}," in the corresponding fields."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select the required ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["scopes"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Save"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"additional-resources","__idx":10},"children":["Additional resources"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://www.zoho.com/crm/developer/docs/api/v3/"},"children":["Zoho CRM API documentation"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://www.zoho.com/accounts/protocol/oauth/web-server-applications.html"},"children":["Zoho OAuth 2.0 guide"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://api-console.zoho.eu/"},"children":["Zoho API Console"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/agen-for-work/connectors/redirect-url"},"children":["How to get your Redirect URL"]}]}]}]}]},"headings":[{"value":"Zoho CRM integration","id":"zoho-crm-integration","depth":2},{"value":"Connect Zoho CRM","id":"connect-zoho-crm","depth":3},{"value":"Step 1: Sign in to the Zoho API Console","id":"step-1-sign-in-to-the-zoho-api-console","depth":4},{"value":"Step 2: Open the API Console","id":"step-2-open-the-api-console","depth":4},{"value":"Step 3: Select a client type","id":"step-3-select-a-client-type","depth":4},{"value":"Step 4: Fill in the application details","id":"step-4-fill-in-the-application-details","depth":4},{"value":"Step 5: Copy your credentials","id":"step-5-copy-your-credentials","depth":4},{"value":"Step 6: Add redirect URIs","id":"step-6-add-redirect-uris","depth":4},{"value":"Step 7: Configure OAuth scopes","id":"step-7-configure-oauth-scopes","depth":4},{"value":"Configure the Frontegg portal","id":"configure-the-frontegg-portal","depth":3},{"value":"Additional resources","id":"additional-resources","depth":3}],"frontmatter":{"seo":{"title":"Zoho CRM integration"}},"lastModified":"2026-05-01T18:45:25.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/agen-for-work/connectors/marketplace/zoho-crm","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}