Pre-requisite

All Zoho Sign APIs require this mandatory header.

  • Authorization - Authentication request header.

Getting Started

There are six steps to access Zoho Sign APIs using OAuth:

  1. Registering a new client
  2. Generating grant token
  3. Generating access and refresh token
  4. Generating access token from refresh token
  5. Revoking refresh token
  6. Calling an API

Registering a new client

First, you need to register your application with Zoho's developer console to get your Client ID and Client Secret.

  1. Log in to https://accounts.zoho.com/developerconsole
  2. Click on Add Client ID
  3. Provide the details and register your application
  4. On successful authentication, you will be provided with Client ID and Client Secret
  5. Do not share the Client ID and Client Secret with anyone

Generating grant token

  1. Go to this authorization URL with the given params: https://accounts.zoho.com/oauth/v2/auth?
  2. On this request, you be will taken to the user consent page.
  3. Click Accept (clicking Deny will throw an error)
  4. Zoho will redirect to the given redirect_uri with code and state param. This code value is mandatory to get the access token in the next step
  5. The code value will be valid for 60 seconds

Example

Copied$ curl https://sign.zoho.com/api/v1/accounts \
    -H 'Authorization: Zoho-oauthtoken <Oauth Token>'