Generate Access Token

Table of Contents

Create Self Client

  1. Go to https://api-console.zoho.com. Click GET STARTED.


    ​
  2. Client Types will be displayed. Click CREATE NOW against Self Client.


    ​
  3. Click CREATE.


    ​
  4. Click OK on the confirmation pop-up.


    ​
  5. The Client ID and Client Secret are readily generated as soon as the Self Client is created.


    ​
  6. The Client ID and Client Secret can be copied using the icons against the respective entities.

    ​

Generate code

  1. Click Generate Code. Type the Scope as "zohobookings.data.CREATE", choose a duration, provide a description and click CREATE.


    ​
  2. The Code is generated for the corresponding Scope.


    ​
  3. The Code can be copied by clicking COPY.


    ​
  4. The parameters required for generating the Access Token can be generated as a JSON file also.
    ​
    ​

    Click DOWNLOAD on the pop-up that appears. The params are downloaded by default as "self_client.json" which can be used to initiate the request later on.

    ​

Request URL

https://accounts.zoho.com/oauth/v2/token

 

Request Method

POST

 

Parameters

Parameters to be passed in the request body as form-data along with the request URL are,

Parameter NameDescription
client_id *The Client ID that is generated on creating the self-client.
client_secret *The Client Secret that is generated on creating the self-client.
grant_type *authorization_code
redirect_uri *https://deluge.zoho.com/delugeauth/callback
code *The code that is generated for the client for a given OAuth scope (say zohobookings.data.CREATE)
Note: fields marked * are mandatory.
 

Response Type

JSON

 

API Limits

Zoho Bookings Plan/EditionNumber of API calls/day
Free250/per user
Basic1000/per user
Premium3000/per user
Zoho One3000/per user
Note: The API limits are excluding the authorization requests. API counts are calculated between 00:00 and 23:59 hours in the respective time zones.

Sample Request

Copiedcurl --location --request 'https://accounts.zoho.com/oauth/v2/token' \
--form 'client_id=1000.3FOH1GTXXXXXXXXXXXXXKZ4YY7XJ3GH' \
--form 'grant_type=authorization_code' \ 
--form 'client_secret=d8ac6ceb5bXXXXXXXXXXXXXXXXXX68c84dcc3e5a3e' \
--form 'redirect_uri=https://deluge.zoho.com/delugeauth/callback' \
--form 'code=1000.981b7845045XXXXXXXXXXXXXXXXXX48e.d92796c8454fa00a8296178c944515f3'

Sample Response

Copied{
    "access_token":"1000.7b3610d1XXXXXXXXXXXXXXXX087cc3.6282226f615637c467bee7209ce1c0a1",
    "refresh_token":"1000.a24d5e6dXXXXXXXXXXXXXXXX3eeb1.0df8a58d58dae3efcd6f0c15c4e88999",
    "api_domain":"https://www.zohoapis.com",
    "token_type":"Bearer",
    "expires_in":3600
}