Zoho Books icon

Zoho Books

Consume Zoho Books API

Actions76

Item → Create

AI-generated

Overview

This node integrates with Zoho Books to create new items in the inventory. It allows users to define detailed item attributes such as name, description, SKU, pricing, tax information, product type, status, unit of measurement, reorder level, and initial stock details. This is useful for businesses managing their product catalog or inventory within Zoho Books, enabling automated creation of items directly from workflows.

Practical examples include:

  • Automatically adding new products to Zoho Books when they are added to an e-commerce platform.
  • Creating service items for billing purposes in Zoho Books based on external service requests.
  • Updating inventory with initial stock levels and pricing when onboarding new products.

Properties

Name Meaning
Item Data Collection of fields describing the item to create, including:
- Name The name of the item (e.g., "Laptop Computer").
- Description A detailed description of the item.
- SKU Stock Keeping Unit code, a unique identifier for the item (e.g., "ITEM-001").
- Rate Selling price of the item (number with 2 decimal precision).
- Purchase Rate Purchase price of the item (number with 2 decimal precision).
- Tax ID The tax associated with the item, selectable from available taxes.
- Tax Exemption ID The tax exemption associated with the item (applicable only in US edition).
- Product Type Whether the item is a physical good or a service. Options: "Goods", "Service".
- Status The status of the item. Options: "Active", "Inactive".
- Unit Unit of measurement for the item (e.g., Piece, Box, Kg).
- Reorder Level Minimum quantity that should be maintained before reordering (non-negative number).
- Initial Stock Initial stock quantity for new items (non-negative number).
- Initial Stock Rate Initial stock rate/price for new items (number with 2 decimal precision).

Output

The node outputs JSON data representing the created item record returned by the Zoho Books API. Each output item corresponds to one input item processed and contains all relevant details of the newly created item as provided by Zoho Books.

If multiple items are created in one execution, the output will be an array of JSON objects, each paired with the corresponding input item index.

No binary data output is produced by this node.

Dependencies

  • Requires an active Zoho Books account with appropriate permissions to create items.
  • Requires an API authentication token or OAuth2 credentials configured in n8n to authorize requests to Zoho Books.
  • The node dynamically imports the Item resource handler internally to perform the create operation.

Troubleshooting

  • Common issues:
    • Missing or invalid API credentials will cause authentication errors.
    • Providing invalid field values (e.g., negative numbers for stock or reorder level) may result in API validation errors.
    • Selecting a Tax ID or Tax Exemption ID that does not exist or is not accessible can cause failures.
  • Error messages:
    • "Unsupported resource: item" indicates the resource was not recognized; ensure the resource parameter is correctly set.
    • API errors from Zoho Books will be passed through; check the error message for details such as missing required fields or invalid data formats.
  • Resolution tips:
    • Verify API credentials and permissions.
    • Double-check field values and types before execution.
    • Use the "Continue On Fail" option in n8n to handle individual item errors gracefully.

Links and References

Discussion