1. Navigate to the Connections page in Zoho Writer.
2. Then, click on Go to Connections > Create Connection in the top-right corner.
3. Select Custom Services tab > Create New Service.
4. Under service details, provide the following information:
5. Select 'OAuth2' from Authentication Type dropdown list.
On choosing OAuth 2 as Authentication Type, you need to provide values to the following fields:
- Grant type: Grant type that the desired service uses to perform authorization. You can choose from the supported grant types: Authorization code and client credentials.
- Client Id: Client ID that is issued by the service provider.
- Client Secret: Your client secret to authorize your application.
- Authorize URL: Authorize URL as specified in the API documentation of the desired service.
- Access Token URL: URL to fetch the access token as specified in the API documentation of the desired service.
- Refresh Token URL: URL to fetch the request token as specified in the API documentation of the desired service.
- Param Type: This decides how the authentication parameters will be sent along with the URLs specified in the invoke URL scripts. Supported param types: Query string, and Header.
- Scope Delimiter (applicable only to OAuth 2 auth type): Delimiter with which the desired service API expects the scopes to be separated.
Note:
1. When registering a Zoho Client in the required service's developer console, the callback URL needs to be:
2. You can select from the supported delimiters: comma, space, and plus. If not specified, comma is assumed as default delimiter. You can choose delimiters only if you provide more than one scope.
6. After filling the field values, click on Create Service.
7. Created custom service will be listed under Pick Your Service option.
8. Scroll down the page to fill the Connection details.
Under connection details, provide the following information:
- Connection Name: Display name of your connection
- Connection LinkName: Link names must be unique and can be used in Deluge integration tasks and invoke URL scripts to establish authentication.
Note: The link name that you provide must satisfy the following conditions:
- It must begin with a lower case letter.
- It can contain lower case letters, numbers, and underscores (_).
- It can contain upto 50 characters.
- Scope (applicable only to OAuth 2 auth type): Scopes required to perform integration as specified in the desired service's API documentation.
9. After filling the field values, click on Create and Connect.
10. A summary of the created connection will be displayed.
11. Upon successful authorization, the connection will be created and listed in your connections page under "My Connections".