How to get Zoho API access and refresh token (Zoho Developer Console)

In this video, we go over how to set up an account with the Zoho API developer console, get API keys, access and authentication tokens, and common GET and POST requests.

If you are more of a visual learner check out my video:

1) Create Client Name in Zoho Developer Console

Sign in to Zoho. If you do not already have an account, you need to create one.

Next, go to the Zoho Developer Console and create a new client. Select ‘Server-Based Applications’ and fill out the rest of the fields:

-Client Type: Served-Based Applications
-Client Name: sgwptest (add any name you would like)
-Homepage URL:
-Authorized Redirect URI:

Before proceeding to make your authorization request, make sure that you have the Postman API client downloaded and open. Zoho provides a short-timed grant code that expires after a minute so super important to have Postman ready to go.

2) Send Authorization Request

Next, we need to send an authorization request to Zoho Accounts. During this step, we want to pass the ‘scope’ of what we will grant this Client access to. Since we want the client to be able to subscribe to users, update users, edit users, and delete users in Zoho Campaigns, we include the scope

Using your client ID, client secret, and redirect URI, send an authorization request in your web browser to Zoho Campaigns.

Here is a sample url below that you can replace with your values:

Approve your request and copy the grant code into your web browser.

3) Generate Access Token & Refresh Token

Open up Postman and enter in the following URL (edit your parameters for code, client ID, client secret, and redirect URI. Here is an example:

You will be provided your access token, refresh token, etc.

4) Use Access Token to make your first POST request[listkey]&

5) Subscribe user to list in Zoho Campaigns


resfmt: JSON
listkey: 58c3908e47768243dbc9a9dbcf4d1bb07461b395c6e88487


Authorization: Zoho-oauthtoken {insert code}
Content-Type: application/x-www-form-urlencoded

I would recommend using a test email of yours. If successful, you will see a message like this:

"code": "0",
"message": "A confirmation email is sent to the user. User needs to confirm to successfully subscribe.",
"version": "1.1",
"uri": "/api/v1.1/json/listsubscribe",
"status": "success"
Simon Gondeck

I’m a big fan of WordPress + WooCommerce (especially WooCommerce Subscriptions). Check out my YouTube channel.

2 thoughts on “How to get Zoho API access and refresh token (Zoho Developer Console)”

  1. Trying to find this video with a non blurry readable view of your text file. No luck anywhere. You give examples in the text but cut each line in half and show … .
    Still no idea what those look like


Leave a Comment