Step 1: Register your application with Zoho
Before you get started with authorization and make any calls using the Zoho Writer APIs, you need to register your application with Zoho Writer.
To register,
Go to Zoho Developer Console.
Choose a client type:
Web Based: Applications that are clients running on a dedicated HTTP server.
Mobile: Applications that are installed on smart phones and tablets.
Non-browser Mobile Applications: Applications for devices without browser provisioning such as smart TVs and printers.
Self Client: Stand-alone applications that perform only back-end jobs (without any manual intervention) like data sync.
For more details, refer to OAuth Overview.
Enter the following details:
Client Name: The name of your application you want to register with Zoho.
Homepage URL: The URL of your web page.
Authorized Redirect URIs: A valid URL of your application to which Zoho Accounts redirects you with a grant token(code) after successful authentication.
- Click CREATE.
You will receive the following credentials:
Client ID: The consumer key generated from the connected app.
Client Secret: The consumer secret generated from the connected app.
Note:
- If you don't have a domain name and a redirect URL, you can use dummy values in their place and register your client.
- Here is avideo explaining how to register your application with Zoho.
Possible Errors
| Error | Reason | Resolution |
| Enter a valid client name | The client name has a special character. | The client name must not contain any special characters except "_" and "&". |
| Enter a valid JavaScript Domain URI | The JavaScript domain is incorrect. | Specify valid JavaScript domains, separated by commas, and they must start with 'http' |
| Enter a valid redirect URI | The redirect URI is incorrect. | Specify a valid redirect URI in the format "https://www.your-domain.com/callback". |
| Enter a valid homepage URL | The homepage URL is invalid. | Specify a valid homepage URL in the format "https://www.yourdomain.com". |
Mandatory Entries for Different Client Types
The following are the mandatory entries for different client types.
| Client Type | Client Name | Homepage URL | Redirect URIs | JS Domains |
| Web-based | Y | Y | Y | NA |
| Mobile | Y | Y | Y | NA |
| Self Client | N | N | N | NA |
| Device | Y | Y | N | NA |