Making the Authorization Request

To use the Zoho Contracts' APIs, the users must authenticate the application to make API calls on their behalf with an access token. The access token, in return, must be obtained from a grant token (authorization code). The Zoho Contracts' APIs use the authorization code grant type to provide access to protected resources.

To get the grant token,

  1. Go to Zoho Developer Console and log in with your Zoho Contracts username and password.
  2. Click Add Client and choose Self Client from the list of client types, then click Create Now.
  3. Click OK in the pop-up to enable a self client for your account. Now, your client ID and client secret are displayed under the Client Secret tab.
  4. Click the Generate Code tab and enter the required scope separated by commas. Refer to our list of Scopes for more details. The system throws an 'Enter a valid scope' error when you enter one or more incorrect scopes.
  5. Select the Time Duration for which the grant token is valid. Please note that after this time, the grant token expires.
  6. Enter a description and click Create.

The organization-specific grant token code for the specified scope will be displayed to copy or download it.

Note:

  • Generating the organization-specific grant token is a one-time process, provided you generate the access and refresh tokens within the time the grant token is valid.