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:
- Registering a new client
- Generating grant token
- Generating access and refresh token
- Generating access token from refresh token
- Revoking refresh token
- 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.
- Log in to https://accounts.zoho.com/developerconsole
- Click on Add Client ID
- Provide the details and register your application
- On successful authentication, you will be provided with Client ID and Client Secret
- Do not share the Client ID and Client Secret with anyone
Generating grant token
- Go to this authorization URL with the given params: https://accounts.zoho.com/oauth/v2/auth?
- On this request, you be will taken to the user consent page.
- Click Accept (clicking Deny will throw an error)
- 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
- 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>'