Multi-DC Support for Bigin APIs
Multi-DC support is a feature in the Zoho API console that allows a single client application (registered in one data center) to access APIs across all supported data centers. This is particularly useful when your application is hosted in one DC (e.g., US), but your users are available across different DCs (e.g., the EU, IN, AU, etc.).
If your app is registered in the US data center but being accessed by a customer in the EU, you need to enable EU DC support in your Zoho API console settings. If not, your app cannot access the customer's data because of regional data restrictions.
To know more details of enabling Multi-DC support in the Zoho API console, see Step 5 of Register your application.
Data centers and their domain URLs
Use the correct domain when constructing your OAuth and API URLs. Here's a list of Bigin data centers and their corresponding domains:
Region | Accounts Domain | API Domain |
|---|---|---|
US | https://accounts.zoho.com | https://www.zohoapis.com |
AU | https://accounts.zoho.com.au | https://www.zohoapis.com.au |
EU | https://accounts.zoho.eu | https://www.zohoapis.eu |
IN | https://accounts.zoho.in | https://www.zohoapis.in |
CN | https://accounts.zoho.com.cn | https://www.zohoapis.com.cn |
JP | https://accounts.zoho.jp | https://www.zohoapis.jp |
SA | https://accounts.zoho.sa | https://www.zohoapis.sa |
CA | https://accounts.zohocloud.ca | https://www.zohoapis.ca |
Making authorization requests
Initiate the request for user authentication using the US (.com) accounts URL when making authorization requests.
Copiedhttps://accounts.zoho.com/oauth/v2/auth?scope=ZohoBigin.users.ALL&client_id={client_id}&response_type=code&access_type={offline_or_online}&redirect_uri={redirect_uri}Note: The authorization requests must initiate from the correct domain based on the user's region to ensure proper redirection and authentication.
Region | Authorization Request URL | Redirection |
|---|---|---|
US, EU, AU, IN, JP, SA, CA | https://accounts.zoho.com | Automatically redirects to the user's DC |
CN | https://accounts.zoho.com.cn | No redirection |
After a successful authorization, the OAuth server returns a response with the location parameter. Here's the sample response:
Copied{redirect_uri}?code={grant_token}&location=us&accounts-server=https://accounts.zoho.comThe location parameter indicates the user's home DC.
The accounts-server provides the OAuth tokens endpoint for that user.