This is a guide on how to get an Zoho API Key to use with Postman.
To use the Zoho APIs, the users must authenticate the application to make API calls with an access token.
The access token, in return, must be obtained from a grant token (authorization code).
So I will show you how you can:
Go to Zoho - API Console at https://api-console.zoho.com/
Click "Add client".
Review the client types and choose that applicable client type for what you need the API for. I will use the "Self Client".
Select "Self Client".
In the "Create New Client" section, click Create
Confirm that you want to enable self-client, click OK.
Take note of the Client Secret details, as you will need that to use in Postman.
Download and install Postman if you have not already.
In Postman, we will download the following file:
We will add this to the following environment variables with their corresponding values:
Sample values would look like the following:
*Leave blank, as it will be generated later when we run an API call for our access token.
In Zoho API Console, generate an authorization-code by going to our Self Client.
Click on "Self Client".
Fill in the "Generate Code" tab and click Create.
*Additional scopes you can use in the future here - Zoho Available Scopes.
Select your portal from the "Select Portal" menu.
Select the org, in my example, this is Production> Vu.
Once you select your org, it will give you a green tick.
You will now have a code generated in the "Generated Code" pop up window. It will look something like one of the examples below (depending on your scope).
Click Copy or Download.
Copy and download the authorization-code from Zoho API Console. In my example it is the following:
1000.9c80875fefb31993a8e27216e26ff5ae.d128b593348bcc15b303f1774672171a
We will then select one of the "Generate Access Token and Refresh Token" API.
With "Generate Access Token and Refresh Token" API open, populate the following with the generated code.
Specifically, we will add it to the "code" spot.
Once tested, you should get something like this:
If you check your Postman environment, you will now see the access token and refresh token autopopulated there. The system automatically adds values for access-token, refresh-token, and expires-in variables.
You're all set now! You can now testing the Zoho CRM API calls.
You can now start making Zoho CRM API calls. Here are some examples.
Using the GET Users from the Zoho CRM Users APIs, we can get these details.
More details on this GET Users API - https://www.zoho.com/crm/developer/docs/api/v2/get-users.html
If we ran the following in our Terminal (using the Access Token generated from earlier) then we could also see something similar as well.
curl "https://www.zohoapis.com/crm/v2/org" -X GET -H "Authorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxf"
Now you can start testing other Zoho CRM APIs. Have fun!