Actions76
- Bill Actions
- Contact Actions
- Credit Note Actions
- Invoice Actions
- Item Actions
- Sales Order Actions
- Tax Actions
- Tax Group Actions
- Tax Exemption (US only) Actions
- Vendor Actions
- Vendor Credit Actions
Tax → Create
AI-generatedOverview
This node integrates with the Zoho Books API to manage tax records. Specifically, the Tax - Create operation allows users to create a new tax entry in their Zoho Books account. This is useful for automating the setup of tax rates such as sales tax, GST, or other applicable taxes within financial workflows.
Typical use cases include:
- Automatically adding new tax rates when onboarding new regions or tax jurisdictions.
- Synchronizing tax configurations from external systems into Zoho Books.
- Setting up compound or non-recoverable taxes programmatically.
For example, a business expanding into a new state can use this node to add that state's sales tax rate directly into Zoho Books without manual entry.
Properties
| Name | Meaning |
|---|---|
| Tax Name | The name of the tax (e.g., "Sales Tax", "GST"). |
| Tax Percentage | The tax percentage rate, between 0 and 100%, supporting up to 2 decimal places (e.g., 8.25). |
| Additional Fields | Optional extra settings: |
| - Is Compound: Whether this tax is compound (tax on tax). | |
| - Is Non-Recoverable: Whether this tax is non-recoverable. | |
| - Tax Authority ID: The identifier of the tax authority. | |
| - Tax Authority Name: The name of the tax authority. |
Output
The node outputs JSON data representing the created tax record as returned by the Zoho Books API. This typically includes details such as the tax ID, name, percentage, and any additional attributes set during creation.
No binary data output is produced by this operation.
Dependencies
- Requires an active connection to the Zoho Books API using OAuth2 authentication.
- The node depends on proper configuration of credentials providing access tokens for Zoho Books.
- No additional environment variables are required beyond standard n8n credential setup.
Troubleshooting
Common Issues:
- Invalid or missing API credentials will cause authentication failures.
- Providing tax percentages outside the allowed range (0-100) or invalid formats may result in validation errors.
- Attempting to create a tax with a duplicate name might be rejected by the API.
Error Messages:
- "Unsupported resource" — indicates the selected resource is not implemented; ensure "Tax" is chosen.
- API errors related to invalid input will usually return descriptive messages from Zoho Books; verify all required fields are correctly filled.
- Network or rate limit errors may occur; retry after some time or check API usage limits.