n8n-nodes-zoho-creator

n8n community node for Zoho Creator API v2.1 using OAuth2 with automatic refresh-token handling delegated to n8n via this.helpers.requestOAuth2.

Authentication model

• Credential extends oAuth2Api.
• Uses authQueryParameters: access_type=offline.
• Uses authentication: body.
• All requests are made with requestOAuth2 and do not implement custom refresh-token logic.

API base URL resolution

Resolution order implemented in code:

1. Explicit credential override (Creator API Base URL)
2. oauthTokenData.api_domain from OAuth token response
3. Fallback mapped from selected regional OAuth URL

Regional API base choices are based on official Creator base URL documentation:

• https://help.zoho.com/portal/en/kb/creator/developer-guide/account-setup/articles/know-your-creator-account-s-base-url

Endpoint audit (official references)

Implemented endpoints and references:

1. Create records

• Endpoint: POST /creator/v2.1/data/{account_owner_name}/{app_link_name}/form/{form_link_name}
• Docs: https://www.zoho.com/creator/help/api/v2.1/add-records.html#requestdetails
• OAS: https://creator.zoho.com/api/v2.1/downloadOAS?api_ref_id=1

2. Get record by ID

• Endpoint: GET /creator/v2.1/data/{account_owner_name}/{app_link_name}/report/{report_link_name}/{record_ID}
• Docs: https://www.zoho.com/creator/help/api/v2.1/get-records-by-ID.html#requestdetails
• OAS: https://creator.zoho.com/api/v2.1/downloadOAS?api_ref_id=2

3. Get records

• Endpoint: GET /creator/v2.1/data/{account_owner_name}/{app_link_name}/report/{report_link_name}
• Docs: https://www.zoho.com/creator/help/api/v2.1/get-records.html#requestdetails
• Params/pagination: https://www.zoho.com/creator/help/api/v2.1/get-records.html#parameters
• OAS: https://creator.zoho.com/api/v2.1/downloadOAS?api_ref_id=3

4. Update record by ID

• Endpoint: PATCH /creator/v2.1/data/{account_owner_name}/{app_link_name}/report/{report_link_name}/{record_ID}
• Docs: https://www.zoho.com/creator/help/api/v2.1/update-specific-record.html#requestdetails
• OAS: https://creator.zoho.com/api/v2.1/downloadOAS?api_ref_id=4

5. Load options: applications

• Endpoint: GET /creator/v2.1/meta/applications
• Docs: https://www.zoho.com/creator/help/api/v2.1/get-applications.html#requestdetails
• OAS: https://creator.zoho.com/api/v2.1/downloadOAS?api_ref_id=19

6. Load options: forms

• Endpoint: GET /creator/v2.1/meta/{account_owner_name}/{app_link_name}/forms
• Docs: https://www.zoho.com/creator/help/api/v2.1/get-forms.html#requestdetails
• OAS: https://creator.zoho.com/api/v2.1/downloadOAS?api_ref_id=15

7. Load options: reports

• Endpoint: GET /creator/v2.1/meta/{account_owner_name}/{app_link_name}/reports
• Docs: https://www.zoho.com/creator/help/api/v2.1/get-reports.html#requestdetails
• OAS: https://creator.zoho.com/api/v2.1/downloadOAS?api_ref_id=16

Required OAuth scopes

Minimum scopes used by implemented operations:

• ZohoCreator.form.CREATE
• ZohoCreator.report.READ
• ZohoCreator.report.UPDATE
• ZohoCreator.dashboard.READ
• ZohoCreator.meta.application.READ

Build

npm run typecheck
npm run build

Publish safety

Check a version before publish:

npm view @trg-admin/n8n-nodes-zoho-creator versions --json

If target version exists, bump and then publish:

npm version patch
npm publish --access public