Kaizen #5 - Environments and Domains in Zoho CRM [Part 1/2]
Hello everyone!
Welcome to another week of Kaizen. In the last Kaizen post, we discussed Troubleshooting OAuth2.0. By now, you must have got a hold on OAuth2.0 authorization. Now let us dive deep into other details related to OAuth2.0.
What you will learn from this post?
If you want to integrate your application with Zoho CRM, this post will help you understand the different environments available, and how to handle different domains for your application.
In this post, we discuss handling domains for self client. In our upcoming post, we will discuss handling domains for web based clients.
Without further adieu, let us dig deep into each topic.
1. Domains in Zoho CRM
Zoho CRM is hosted at multiple data centers. Therefore, the URL with which you make API calls also depends on the data center. This makes integration simpler. The following are the different domains available.
a. Europe (.eu)
b. Australia (.com.au)
c. India (.in)
d. US (.com)
e. China (.com.cn)
2. Handling Domains for Self Client
In our previous posts, we discussed different types of clients in OAuth Authorization—Self Client and Web Based. In this post, we will discuss handling domains for self client.
2a. Procedure to know your accounts domain via CRM UI
To know in which domain your Zoho CRM account is in, follow the below mentioned steps:
Step 1: Go to Profile and click My Account.
Step 2: In the address bar, you can see your domain. In the below screenshot, the domain is com.
2b. Role of domains while registering the client
While registering your self client, append the domain of your Zoho CRM account (that you noticed in the previous section) to the accounts URL.
Link: https://api-console.zoho.{domain}
This link is your domain-specific accounts URL. For instance, for Europe domain, the domain-specific link is https://api-console.zoho.eu
2c. Making the Authorization Request
After registering your self client, authorize your client to generate grant token. To know how, refer 5th point under How to use Self Client in Kaizen #2.
2d. Role of domains while generating tokens
While generating access and refresh tokens for your self client, use your domain-specific accounts URL.
For Europe: https://accounts.zoho.eu
For Australia: https://accounts.zoho.com.au
For India: https://accounts.zoho.in
For US: https://accounts.zoho.com
For China: https://accounts.zoho.com.cn
In the response, along with access and refresh tokens, you will receive "api_domain". Make API calls to Zoho CRM using this domain URL.
- The "api_domain" you receive in the response, is your current api_domain.
- Make all API calls from this api_domain. Example: https://www.zohoapis.eu/crm/v2/Leads will be the URL to fetch all leads from the Leads module in the EU domain.
- Even if the api_domain is altered, it gets updated in the response.
- Store these details in your application DB—access token, refresh token, api_domain, expires_in.
- When the access token expires, you can generate new access token with the refresh tokens–. Update the new access token in your DB and use it to make subsequent API calls.
3. Environments
There are three environments in Zoho CRM.
- Production - The production environment is your live CRM account, which you use for business needs.
Use the following URL to make API calls from the Production environment-https://www.zohoapis.com - Developer - The developer environment is an ideal training ground for developers. You can play around with the CRM account and test robust CRM implementations, Zoho CRM-centric mobile and web apps, white-labelled Vertical CRMs, and CRM extensions. You can have a Developer Edition in parallel with a regular CRM. In essence, two accounts for the same user.
Use the following URL to make API calls from the Developer environment-https://developer.zohoapis.com - Sandbox - In this environment, you can test your Zoho CRM settings before you can take it to your production setup. This way, you can feel much safer about the changes in your settings, since you can test them, identify issues, and fix them before you take them to your actual working setup.
Use the following URL to make API calls from the Sandbox environment-https://sandbox.zohoapis.com
Note:
- The Sandbox environment is available only for the enterprise and above editions.
- If the environment is not specified, the API calls are reflected in the production environment.
- Based on the domain, the URL to make API calls for each environment will vary. For instance, the URL to make API calls from the sandbox environment in Europe domain will be https://sandbox.zohoapis.eu
We hope you found this post useful. Keep a tab on this series for more exciting topics!
Reach out to us at support@zohocrm.com if you have any questions, or let us know in the comment section.
We will meet you next week with another useful topic.
Cheers!
Previous 'Kaizen' - Troubleshooting OAuth2.0
Next 'Kaizen' - Environments and Domains in Zoho CRM [Part2/2]
Access your files securely from anywhere
Zoho Developer Community
New to Zoho LandingPage?
Zoho LandingPage Resources
New to Zoho Survey?
New to Zoho CRM Plus?
Deliver unforgettable customer experiences
New to Zoho CRM Plus?
Deliver unforgettable customer experiences
New to Zoho Marketing Plus?
Everything you need to run your marketing
New to Zoho Marketing Plus?
Everything you need to run your marketing
New to Bigin?
Topic Participants
Sneha Sridharan
Sticky Posts
Kaizen #165 : How to call Zoho CRM APIs using Client Script
Welcome back to another exciting Client Script post! In this post, we will discuss one of the most frequently asked questions: How do you call Zoho CRM APIs from Client Scripts? In this kaizen post, 1. Ways to make calls to Zoho CRM APIs using ClientKaizen#162 : Add Tags and Open Pre-filled Email Drafts via Client Scripts
Hello everyone! Welcome to another informative Kaizen post. In this post, let us see how to accomplish the following using Client Script. 1. How to auto-tag a record based on field update? 2. How to Open a pre-filled email draft This post will provideClient Script | Update - Introducing Commands in Client Script!
Have you ever wished you could trigger Client Script from contexts other than just the supported pages and events? Have you ever wanted to leverage the advantage of Client Script at your finger tip? Discover the power of Client Script - Commands! CommandsExtension Pointers - JS SDK series #4: Managing data from a widget using ZOHO.CRM.HTTP
Handling and managing the data between two applications is a major factor for an efficient business. There are a variety of ways to handle data between Zoho CRM and other third-party applications. You can use deluge CRM tasks, create connectors, use APIKaizen #152 - Client Script Support for the new Canvas Record Forms
Hello everyone! Have you ever wanted to trigger actions on click of a canvas button, icon, or text mandatory forms in Create/Edit and Clone Pages? Have you ever wanted to control how elements behave on the new Canvas Record Forms? This can be achieved
New to Zoho TeamInbox?
Zoho TeamInbox Resources
Zoho DataPrep Resources
Zoho CRM Plus Resources
Zoho Books Resources
Zoho Subscriptions Resources
Zoho Projects Resources
Zoho Sprints Resources
Qntrl Resources
Zoho Creator Resources
Zoho Campaigns Resources
Zoho CRM Resources
Design. Discuss. Deliver.
Zoho Show Resources
Get Started. Write Away!
Writer is a powerful online word processor, designed for collaborative work.
Zoho CRM コンテンツ
-
オンラインヘルプ
-
Webセミナー
-
機能活用動画
-
よくある質問
-
Ebook
-
-
Zoho Campaigns
- Zoho サービスのWebセミナー