# Zoho Inventory

Zoho Inventory helps businesses track stock, manage orders, and sync inventory across multiple sales channels, streamlining supply chain operations

- **Category:** accounting
- **Auth:** OAUTH2
- **Composio Managed App Available?** Yes
- **Tools:** 58
- **Triggers:** 0
- **Slug:** `ZOHO_INVENTORY`
- **Version:** 20260309_00

## Tools

### Add Credit Note Comment

**Slug:** `ZOHO_INVENTORY_ADD_CREDIT_NOTE_COMMENT`

Tool to add a comment to a credit note in Zoho Inventory. Use when needing to add notes or comments to a specific credit note for record-keeping or audit purposes.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `description` | string | Yes | A brief description about the item. |
| `creditnote_id` | string | Yes | Unique identifier of the credit note. |
| `organization_id` | string | No | Organization ID. If not provided, uses the configured org or first available org. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Add Invoice Attachment

**Slug:** `ZOHO_INVENTORY_ADD_INVOICE_ATTACHMENT`

Tool to upload an attachment to a specific invoice. Use when you need to add a file attachment to an invoice.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `file_path` | string | No | Absolute path to a local file to upload. If provided, this takes precedence over 'attachment'. Allowed extensions: gif, png, jpeg, jpg, bmp, pdf. |
| `attachment` | object | No | File to attach. Allowed extensions: gif, png, jpeg, jpg, bmp, pdf. Either 'attachment' or 'file_path' must be provided. |
| `invoice_id` | string | Yes | Unique identifier of the invoice to attach the file to. |
| `organization_id` | string | No | Organization ID. If not provided, uses the configured org or first available org. |
| `can_send_in_mail` | boolean | No | If true, the attachment will be included when emailing the invoice to the customer. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Add Invoice Comment

**Slug:** `ZOHO_INVENTORY_ADD_INVOICE_COMMENT`

Tool to add a comment to a specific invoice in Zoho Inventory. Use when you need to add notes, updates, or internal/client-visible comments to an invoice.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `invoice_id` | string | Yes | Unique identifier of the invoice to add the comment to |
| `description` | string | Yes | The description or content of the comment to add to the invoice |
| `organization_id` | string | No | Organization ID. If not provided, uses the configured org or first available org. |
| `payment_expected_date` | string | No | The expected date of payment in YYYY-MM-DD format. Optional field to track when payment is anticipated. |
| `show_comment_to_clients` | boolean | No | If true, the comment will be visible to clients when they view the invoice. If false or not provided, the comment will be internal only. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Apply Credits To Invoices

**Slug:** `ZOHO_INVENTORY_APPLY_CREDITS_TO_INVOICES`

Tool to apply credits from a credit note to one or more invoices. Use when you need to apply available credits from a credit note to settle invoice balances.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `invoices` | array | Yes | List of invoices for which the credit note has been raised. This contains invoice_id and amount_applied. |
| `creditnote_id` | string | Yes | Unique identifier of the credit note. |
| `organization_id` | string | Yes | ID of the organization |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Bulk Delete Sales Orders

**Slug:** `ZOHO_INVENTORY_BULK_DELETE_SALES_ORDERS`

Tool to bulk delete sales orders. Use this to remove multiple sales orders at once.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `salesorder_ids` | string | Yes | Comma-separated list of sales order IDs to delete |
| `organization_id` | string | No | Organization ID. If not provided, uses the configured org or first available org. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Bulk Email Invoices

**Slug:** `ZOHO_INVENTORY_BULK_EMAIL_INVOICES`

Sends multiple invoices by email to a contact in a single API call. Use this tool when you need to email up to 10 invoices at once to a customer. The invoices will be scheduled for delivery and the contact will receive individual emails for each invoice. If contact_id is not provided, the action will automatically fetch the customer_id from the first invoice and use that as the contact.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `contact_id` | string | No | Contact ID (customer) to send the invoices to. If not provided, the action will fetch the contact from the first invoice. |
| `send_email` | boolean | No | Whether to send the invoices via email. Defaults to True. |
| `invoice_ids` | string | Yes | Comma-separated invoice IDs to email (up to 10 invoices). |
| `organization_id` | string | No | Organization ID. If not provided, uses the configured org or first available org. |
| `send_snail_mail` | boolean | No | Whether to send the invoices via snail mail (physical mail). Defaults to False. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Bulk Export Invoices

**Slug:** `ZOHO_INVENTORY_BULK_EXPORT_INVOICES`

Tool to bulk export invoices as a single PDF. Use when you need to download multiple invoices in a single file for archiving or sharing.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `invoice_ids` | string | Yes | Comma-separated list of invoice IDs to export as PDF. Maximum 25 invoice IDs allowed per request. Invoice IDs can be obtained from the List Invoices endpoint. |
| `organization_id` | string | No | Organization ID. If not provided, uses the configured org or first available org. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Bulk Print Invoices

**Slug:** `ZOHO_INVENTORY_BULK_PRINT_INVOICES`

Generate a consolidated PDF containing multiple invoices for printing or archiving. Use this tool to download one or more invoices as a single PDF document. The PDF can contain up to 25 invoices and is useful for bulk printing, record keeping, or sharing with customers.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `invoice_ids` | string | Yes | Comma-separated list of invoice IDs to print as PDF. Maximum 25 invoices allowed per request. Invoice IDs are numeric strings obtained from invoice list or invoice creation responses. |
| `organization_id` | string | No | Organization ID. If not provided, uses the configured org or first available org. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Bulk Print Packages

**Slug:** `ZOHO_INVENTORY_BULK_PRINT_PACKAGES`

Tool to bulk print package slips as a consolidated PDF. Use when you need a PDF file of multiple package slips for printing or archiving.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `package_ids` | string | Yes | Comma-separated list of package IDs to print as PDF. Package IDs can be retrieved from a sales order's package details or via the list packages API. |
| `organization_id` | string | No | Organization ID. If not provided, uses the configured org or first available org. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Cancel Invoice Write Off

**Slug:** `ZOHO_INVENTORY_CANCEL_INVOICE_WRITE_OFF`

Tool to cancel write off for an invoice. Use when undoing a previously applied write off on an invoice after verifying the invoice has a write off applied.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `invoice_id` | string | Yes | The unique identifier (ID) of the invoice whose write-off should be cancelled. The invoice must have an existing write-off applied. |
| `organization_id` | string | No | The Zoho Inventory organization ID. If not provided, the default organization is automatically used. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Bill

**Slug:** `ZOHO_INVENTORY_CREATE_BILL`

Tool to create a bill in Zoho Inventory. Use when a vendor supplies goods/services on credit and you need to track the amount owed.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `date` | string | Yes | Bill date in YYYY-MM-DD format |
| `notes` | string | No | Notes to be added to the bill (internal use) |
| `terms` | string | No | Terms and conditions for the bill |
| `due_date` | string | Yes | Due date for the bill payment in YYYY-MM-DD format |
| `vendor_id` | string | Yes | Unique identifier of the vendor from whom goods/services are purchased |
| `line_items` | array | Yes | List of line items in the bill. At least one line item is required. |
| `bill_number` | string | Yes | Bill number to identify the bill. Must be unique. |
| `currency_id` | string | No | ID of the currency for the bill. If not specified, uses the organization's base currency. |
| `custom_fields` | array | No | List of custom fields for the bill |
| `exchange_rate` | number | No | Exchange rate for the currency. Required if currency_id is specified and different from base currency. |
| `organization_id` | string | No | Organization ID. If not provided, uses the configured org or first available org. |
| `is_inclusive_tax` | boolean | No | Whether the line item rates are inclusive of tax |
| `reference_number` | string | No | Reference number for the bill (e.g., vendor's invoice number) |
| `is_item_level_tax_calc` | boolean | No | Whether tax should be calculated at the item level. If true, tax is applied to each line item. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Contact

**Slug:** `ZOHO_INVENTORY_CREATE_CONTACT`

Tool to create a new contact (customer or vendor) in Zoho Inventory. Use when you need to add a new business relationship to your organization.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `notes` | string | No | Additional notes about the contact |
| `website` | string | No | Website URL of the contact |
| `currency_id` | string | No | Currency ID for the contact's transactions |
| `company_name` | string | No | Name of the contact's company. Maximum length 200 characters. |
| `contact_name` | string | Yes | Name of the contact (organization or individual). Maximum length 200 characters. |
| `contact_type` | string ("customer" | "vendor") | No | Type of contact - customer or vendor. |
| `language_code` | string ("de" | "en" | "es" | "fr" | "it" | "ja" | "nl" | "pt" | "sv" | "zh") | No | Supported language codes for contact communication. |
| `payment_terms` | integer | No | Net payment term for the contact in days (e.g., 30 for Net 30) |
| `billing_address` | object | No | Address information for billing or shipping. |
| `contact_persons` | array | No | List of contact persons representing this contact |
| `organization_id` | string | No | Zoho Inventory organization ID. If not provided, uses the configured default or first available organization. |
| `shipping_address` | object | No | Address information for billing or shipping. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Contact Person

**Slug:** `ZOHO_INVENTORY_CREATE_CONTACT_PERSON`

Tool to create a contact person. Use when you need to add a new contact person to an existing contact in Zoho Inventory.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | No | Email ID of the contact person. Maximum length allowed [100] |
| `phone` | string | No | Phone number of the contact person. Maximum length [50] |
| `skype` | string | No | skype address of the contact person. Maximum length [50] |
| `mobile` | string | No | Mobile/Cell number of the contact person. Maximum length [50] |
| `last_name` | string | No | Last Name of the contact. Maximum length allowed [100] |
| `contact_id` | string | Yes | ID of the contact person |
| `department` | string | No | department to which the contact person belongs. Maximum length [50] |
| `first_name` | string | Yes | First Name of the contact. Maximum length allowed [100] |
| `salutation` | string | No | Salutation for the contact. Maximum length allowed [25] |
| `designation` | string | No | designation of the contact person in the organisation. Maximum length [50] |
| `enable_portal` | boolean | No | option to enable or disable portal access the contact person. allowed values true, false |
| `organization_id` | string | No | Organization ID. If not provided, uses the configured org or first available org. |
| `communication_preference` | object | No | Preferred modes of communication for the contact person. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Credit Note

**Slug:** `ZOHO_INVENTORY_CREATE_CREDIT_NOTE`

Tool to create a new credit note in Zoho Inventory. Use when you need to issue a credit note to a customer for returns, refunds, or adjustments.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `date` | string | Yes | The date on which the credit note was raised. Format: yyyy-mm-dd |
| `notes` | string | No | A short note for the credit note. Max length 5000 characters. |
| `terms` | string | No | Terms & condition to be displayed in the credit note. Max length 10000 characters. |
| `gst_no` | string | No | 15 digit GST identification number of the customer |
| `tax_id` | string | No | Unique ID to denote the tax associated with the credit note |
| `is_draft` | boolean | No | Set to true if credit note has to be created in draft status. Default is false. |
| `cfdi_usage` | string ("acquisition_of_merchandise" | "return_discount_bonus" | "general_expense" | "buildings" | "furniture_office_equipment" | "transport_equipment" | "computer_equipmentdye_molds_tools" | "telephone_communication" | "satellite_communication" | "other_machinery_equipment" | "hospital_expense" | "medical_expense_disability" | "funeral_expense" | "donation" | "interest_mortage_loans" | "contribution_sar" | "medical_expense_insurance_pormium" | "school_transportation_expense" | "deposit_saving_account" | "payment_educational_service" | "no_tax_effect" | "payment" | "payroll") | No | CFDI Usage options. |
| `invoice_id` | string | No | Invoice ID of the required invoice to create a credit note against |
| `line_items` | array | Yes | Line items of the credit note. At least one line item is required. |
| `customer_id` | string | Yes | Customer ID of the customer for whom the credit note is raised |
| `location_id` | string | No | Location ID |
| `template_id` | string | No | Unique ID of the credit note template |
| `custom_fields` | array | No | Additional custom fields for the credit note |
| `exchange_rate` | string | No | Exchange rate for the currency associated with the customer |
| `gst_treatment` | string ("business_gst" | "business_none" | "overseas" | "consumer") | No | GST treatment options. |
| `tax_treatment` | string ("vat_registered" | "vat_not_registered" | "gcc_vat_not_registered" | "gcc_vat_registered" | "non_gcc" | "dz_vat_registered" | "dz_vat_not_registered" | "home_country_mexico" | "border_region_mexico" | "non_mexico") | No | Tax treatment options. |
| `vat_treatment` | string ("uk" | "eu_vat_registered" | "eu_vat_not_registered" | "non_eu" | "overseas") | No | VAT treatment options. |
| `avatax_tax_code` | string | No | A tax code is a unique label used to group Items. Max length 25 characters. |
| `avatax_use_code` | string | No | Used to group like customers for exemption purposes. Max length 25 characters. |
| `organization_id` | string | No | Organization ID. If not provided, uses the configured org or first available org. |
| `place_of_supply` | string | No | Place where the goods/services are supplied. If not given, place of contact will be used. For GCC: AB, AJ, DU, FU, RA, SH, UM, AE, SA, BH, KW, OM, QA. |
| `avatax_exempt_no` | string | No | Exemption certificate number of the customer. Max length 25 characters. |
| `is_inclusive_tax` | boolean | No | Used to specify whether the line item rates are inclusive (true) or exclusive (false) of tax. |
| `reference_number` | string | No | Reference number for the credit note. Max length 100 characters. |
| `tax_authority_id` | string | No | Unique ID of the tax authority. Tax authority depends on the location of the customer. |
| `tax_exemption_id` | string | No | Unique ID of the tax exemption |
| `creditnote_number` | string | No | Unique credit note number (starts with CN). Max length 100 characters. Only provide if ignore_auto_number_generation is true. |
| `cfdi_reference_type` | string ("credit_note" | "debit_note" | "return_of_merchandise" | "substitution_previous_cfdi" | "transfer_of_goods" | "invoice_generated_from_order" | "cfdi_for_advance") | No | CFDI Reference Type options. |
| `contact_persons_associated` | array | No | Contact persons associated with the credit note |
| `ignore_auto_number_generation` | boolean | No | Set to true if you need to provide your own credit note number. Default is false. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Customer Payment

**Slug:** `ZOHO_INVENTORY_CREATE_CUSTOMER_PAYMENT`

Tool to create a customer payment in Zoho Inventory. Use when recording a payment received from a customer against one or more invoices.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `date` | string | No | Date on which payment is made. Format: yyyy-mm-dd. If not provided, current date is used. |
| `amount` | number | Yes | Amount paid in the respective payment |
| `invoices` | array | Yes | List of invoices to apply this payment to. Each invoice requires invoice_id and amount_applied. |
| `account_id` | string | No | ID of the cash/bank account the payment has to be deposited |
| `customer_id` | string | Yes | Customer ID of the customer involved in the payment |
| `description` | string | No | Description about the payment |
| `location_id` | string | No | Location ID |
| `bank_charges` | number | No | Any additional bank charges |
| `payment_form` | string | No | Mode of Vendor Payment |
| `payment_mode` | string ("check" | "cash" | "creditcard" | "banktransfer" | "bankremittance" | "autotransaction" | "others") | Yes | Mode through which payment is made. Maximum length 100. |
| `custom_fields` | array | No | Additional custom fields for the payment |
| `exchange_rate` | number | No | Exchange rate for the currency used in the invoices and customer's currency. The payment amount would be the multiplicative product of the original amount and the exchange rate. Default is 1. |
| `tax_account_id` | string | No | ID of the tax account, in case of withholding tax |
| `organization_id` | string | No | Organization ID. If not provided, uses the configured org or first available org. |
| `reference_number` | string | No | Reference number generated for the payment. A string of your choice can also be used as the reference number. Maximum length 100. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Invoice

**Slug:** `ZOHO_INVENTORY_CREATE_INVOICE`

Tool to create a new invoice in Zoho Inventory. Use when you need to invoice a customer for products or services sold.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `date` | string | No | Invoice date in YYYY-MM-DD format. Defaults to current date if not provided. |
| `notes` | string | No | Customer notes or thank you message to display at the bottom of the invoice |
| `terms` | string | No | Terms and conditions to display on the invoice |
| `gst_no` | string | No | GST number for the invoice (applicable for India) |
| `discount` | number | No | Discount amount or percentage to apply at invoice level |
| `due_date` | string | No | Due date for payment in YYYY-MM-DD format |
| `adjustment` | number | No | Adjustment amount (can be positive or negative) to apply to the invoice total |
| `line_items` | array | Yes | List of line items to include in the invoice. At least one line item is required. |
| `project_id` | string | No | Project ID to associate with the invoice |
| `customer_id` | string | Yes | Unique identifier of the customer for whom the invoice is being created |
| `location_id` | string | No | Location ID to associate with the invoice |
| `template_id` | string | No | ID of the template to use for the invoice PDF |
| `custom_fields` | array | No | List of custom field values for the invoice |
| `discount_type` | string | No | Type of discount: 'entity_level' or 'item_level' |
| `exchange_rate` | number | No | Exchange rate for foreign currency invoices |
| `gst_treatment` | string | No | GST treatment classification (applicable for India) |
| `payment_terms` | integer | No | Payment terms in days (e.g., 30 for Net 30) |
| `invoice_number` | string | No | Custom invoice number. If not provided, Zoho Inventory will auto-generate one. |
| `organization_id` | string | No | Zoho Inventory organization ID. If not provided, uses the configured default or first available organization. |
| `payment_options` | object | No | Payment option configuration. |
| `shipping_charge` | number | No | Shipping charge amount to add to the invoice |
| `is_inclusive_tax` | boolean | No | Whether the tax is inclusive in the item rate (true) or exclusive (false) |
| `reference_number` | string | No | Reference number for the invoice (e.g., purchase order number) |
| `salesperson_name` | string | No | Name of the salesperson associated with the invoice |
| `payment_terms_label` | string | No | Custom payment terms label (e.g., 'Due on Receipt', 'Net 30') |
| `adjustment_description` | string | No | Description for the adjustment amount |
| `allow_partial_payments` | boolean | No | Whether to allow partial payments for the invoice |
| `is_discount_before_tax` | boolean | No | Whether to apply discount before tax calculation (true) or after (false) |
| `contact_persons_associated` | array | No | List of contact person IDs to associate with the invoice |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Item

**Slug:** `ZOHO_INVENTORY_CREATE_ITEM`

Tool to create a new item in Zoho Inventory. Use when you need to add a new product or service to your inventory catalog.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ean` | string | No | 13-digit European Article Number for product identification |
| `sku` | string | No | Stock Keeping Unit code - unique identifier for inventory tracking |
| `upc` | string | No | 12-digit Universal Product Code for retail scanning |
| `isbn` | string | No | International Standard Book Number for book products |
| `name` | string | Yes | Name of the item (required) |
| `rate` | number | No | Sales price of the item |
| `unit` | string | No | Measurement unit for the item (e.g., pcs, kg, hrs) |
| `tax_id` | string | No | ID of the tax to be associated with the item |
| `item_type` | string ("inventory" | "sales" | "purchases" | "sales_and_purchases") | No | Category of item for tracking purposes. |
| `vendor_id` | string | No | ID of the preferred supplier vendor |
| `is_taxable` | boolean | No | Whether the item is subject to tax |
| `description` | string | No | Detailed description of the item |
| `part_number` | string | No | Manufacturer's part number or component identifier |
| `vendor_name` | string | No | Name of the preferred supplier vendor |
| `product_type` | string ("goods" | "service") | No | Type of product being sold. |
| `purchase_rate` | number | No | Cost price for purchasing the item |
| `reorder_level` | number | No | Minimum stock quantity threshold that triggers a reorder alert |
| `organization_id` | string | No | Zoho Inventory organization ID. If not provided, uses the configured default or first available organization. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Item Group

**Slug:** `ZOHO_INVENTORY_CREATE_ITEM_GROUP`

Tool to create an item group in Zoho Inventory. Use when you need to create a new item group with multiple items that share common attributes like size or color variations.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `unit` | string | Yes | Unit of measurement for the item group (required, e.g., qty, pcs, kg) |
| `brand` | string | No | Brand name of the item group |
| `items` | array | No | List of items to be included in the item group. Each item must have name, rate, and purchase_rate. |
| `tax_id` | integer | No | ID of the tax to be applied to the item group |
| `attributes` | array | No | List of attributes for the item group (e.g., Size, Color). Each attribute can have multiple options. |
| `group_name` | string | Yes | Name of the item group (required) |
| `description` | string | No | Description of the item group |
| `manufacturer` | string | No | Manufacturer of the item group |
| `custom_fields` | array | No | Custom fields for the item group |
| `attribute_name1` | string | No | Name of the first attribute |
| `organization_id` | string | No | Organization ID. If not provided, uses the configured org or first available org. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Package

**Slug:** `ZOHO_INVENTORY_CREATE_PACKAGE`

Tool to create a package for a sales order in Zoho Inventory. Use when you need to prepare items from a sales order for shipping.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `date` | string | Yes | Date on which the package is prepared in YYYY-MM-DD format |
| `notes` | string | No | Notes or additional information about the package |
| `line_items` | array | Yes | Details of the items in this package. At least one line item is required. |
| `custom_fields` | array | No | Custom fields for the package with their values |
| `salesorder_id` | integer | Yes | Unique ID of the sales order for which the package is being created |
| `package_number` | string | Yes | Name/number of the package for identification. |
| `organization_id` | string | No | Organization ID. If not provided, uses the configured org or first available org. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Purchase Order

**Slug:** `ZOHO_INVENTORY_CREATE_PURCHASE_ORDER`

Tool to create a purchase order in Zoho Inventory. Use when you need to order goods or services from a vendor.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `date` | string | No | Purchase order creation date in YYYY-MM-DD format. Defaults to current date if not specified. |
| `notes` | string | No | Internal notes for the purchase order |
| `terms` | string | No | Terms and conditions for the purchase order |
| `vendor_id` | string | Yes | Unique identifier of the vendor from whom goods/services will be purchased |
| `line_items` | array | Yes | Collection of items to be ordered. At least one line item is required. |
| `delivery_date` | string | No | Expected delivery date in YYYY-MM-DD format |
| `organization_id` | string | No | Organization ID. If not provided, uses the configured org or first available org. |
| `reference_number` | string | No | Reference number for the purchase order (for internal tracking) |
| `purchaseorder_number` | string | No | The purchase order identification number. If not provided, auto-generated. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Sales Order

**Slug:** `ZOHO_INVENTORY_CREATE_SALES_ORDER`

Tool to create a sales order in Zoho Inventory. Use when a customer places an order for products and you need to track the sale before invoicing.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `date` | string | No | Sales order date in YYYY-MM-DD format. If not provided, current date is used. |
| `notes` | string | No | Internal notes for the sales order |
| `terms` | string | No | Terms and conditions for the sales order |
| `gst_no` | string | No | GST identification number (India) |
| `discount` | number | No | Discount percentage to be applied to the entire order (0-100) |
| `adjustment` | number | No | Adjustment amount (positive or negative) to the order total |
| `line_items` | array | Yes | List of line items in the sales order. At least one line item is required. |
| `customer_id` | string | Yes | Unique identifier of the customer for whom the sales order is being created |
| `estimate_id` | string | No | ID of the estimate to convert into sales order |
| `template_id` | string | No | ID of the template to be used for the sales order |
| `custom_fields` | array | No | List of custom fields for the sales order |
| `discount_type` | string | No | Type of discount: 'entity_level' or 'item_level' |
| `gst_treatment` | string | No | GST treatment type (India): business_gst, business_none, overseas, consumer |
| `shipment_date` | string | No | Expected shipment date in YYYY-MM-DD format |
| `salesperson_id` | string | No | ID of the salesperson associated with this order |
| `billing_address` | object | No | Address information for billing or shipping. |
| `organization_id` | string | No | Organization ID. If not provided, uses the configured org or first available org. |
| `place_of_supply` | string | No | Place of supply for the sales order (India GST) |
| `shipping_charge` | number | No | Shipping charge amount to be added to the order total |
| `is_inclusive_tax` | boolean | No | Whether the line item rates are inclusive of tax |
| `reference_number` | string | No | Reference number for the sales order (e.g., customer's PO number) |
| `shipping_address` | object | No | Address information for billing or shipping. |
| `salesorder_number` | string | No | Custom sales order number. If not provided, Zoho generates one automatically. |
| `adjustment_description` | string | No | Description of the adjustment made to the order total |
| `is_discount_before_tax` | boolean | No | Whether discount should be applied before tax calculation |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Deactivate Contact

**Slug:** `ZOHO_INVENTORY_DEACTIVATE_CONTACT`

Tool to mark a contact as inactive in Zoho Inventory. Use when you need to deactivate a contact without permanently deleting it.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `contact_id` | string | Yes | Unique identifier of the contact to mark as inactive. |
| `organization_id` | string | No | Organization ID. If not provided, uses the configured org or first available org. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Deactivate Item

**Slug:** `ZOHO_INVENTORY_DEACTIVATE_ITEM`

Tool to mark an item as inactive in Zoho Inventory. Use when you need to deactivate an item without permanently deleting it.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `item_id` | string | Yes | Unique identifier of the item to mark as inactive. |
| `organization_id` | string | No | Organization ID. If not provided, uses the configured org or first available org. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Deactivate Item Group

**Slug:** `ZOHO_INVENTORY_DEACTIVATE_ITEM_GROUP`

Tool to mark an item group as inactive in Zoho Inventory. Use when you need to deactivate an item group and all its items without permanently deleting them.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `itemgroup_id` | string | Yes | Unique identifier of the item group to mark as inactive. |
| `organization_id` | string | No | Organization ID. If not provided, uses the configured org or first available org. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Composite Item

**Slug:** `ZOHO_INVENTORY_DELETE_COMPOSITE_ITEM`

Permanently deletes a composite item from Zoho Inventory. A composite item (also known as a bundle or kit) is a product made up of multiple individual inventory items sold together as a single unit. This action removes the composite item definition but does not affect the underlying component items. Prerequisites: - Composite items feature must be enabled in the organization's item preferences - The composite item must exist and not be associated with active transactions Common error codes: - 2006: Resource does not exist (invalid composite_item_id) - 2054: Composite items feature not enabled in organization settings API Endpoint: DELETE /inventory/v1/compositeitems/{composite_item_id}

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `organization_id` | string | No | Zoho Inventory organization ID. If not provided, the action will use the default configured organization or fetch the first available organization from the account. |
| `composite_item_id` | string | Yes | Unique identifier of the composite item to delete. This is a numeric ID returned when listing or creating composite items (e.g., from GET /compositeitems or POST /compositeitems). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Contact

**Slug:** `ZOHO_INVENTORY_DELETE_CONTACT`

Tool to delete a contact. Use when you need to remove an existing contact from your organization after confirming it is no longer needed.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `contact_id` | string | Yes | Unique identifier of the contact to delete |
| `organization_id` | string | No | Organization ID. If not provided, uses the configured org or first available org. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Contact Person

**Slug:** `ZOHO_INVENTORY_DELETE_CONTACT_PERSON`

Tool to delete a contact person. Use when you need to remove a contact person from your organization after confirming it is no longer needed.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `organization_id` | string | No | Organization ID. If not provided, uses the configured org or first available org. |
| `contact_person_id` | string | Yes | Unique identifier of the contact person to delete |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Invoice

**Slug:** `ZOHO_INVENTORY_DELETE_INVOICE`

Tool to delete an invoice. Use when you need to remove an existing invoice that has no payments or credits applied.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `invoice_id` | string | Yes | Unique identifier of the invoice to delete |
| `organization_id` | string | No | Organization ID. If not provided, uses the configured org or first available org. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Invoice Attachment

**Slug:** `ZOHO_INVENTORY_DELETE_INVOICE_ATTACHMENT`

Tool to delete an invoice attachment. Use when you need to remove a file attached to an invoice.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `invoice_id` | string | Yes | Unique identifier of the invoice to remove the attachment from |
| `organization_id` | string | No | Organization ID. If not provided, uses the configured org or first available org. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Invoice Comment

**Slug:** `ZOHO_INVENTORY_DELETE_INVOICE_COMMENT`

Delete a specific comment from an invoice in Zoho Inventory. Zoho API: DELETE /inventory/v1/invoices/{invoice_id}/comments/{comment_id} Required query param: organization_id Auth header format: Authorization: Zoho-oauthtoken <access_token>

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `comment_id` | string | Yes | Unique identifier of the comment to delete |
| `invoice_id` | string | Yes | Unique identifier of the invoice |
| `organization_id` | string | No | Organization ID. If not provided, uses the configured org or first available org. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Item

**Slug:** `ZOHO_INVENTORY_DELETE_ITEM`

Tool to delete an item. Use when you need to remove an existing inventory item after confirming it is not referenced in any transactions.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `item_id` | string | Yes | Unique identifier of the item to delete |
| `organization_id` | string | No | Organization ID. If not provided, uses the configured org or first available org. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Item Group

**Slug:** `ZOHO_INVENTORY_DELETE_ITEM_GROUP`

Tool to delete an item group. Use to remove an existing item group that is no longer needed.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `itemgroup_id` | string | Yes | Unique identifier of the item group to delete |
| `organization_id` | string | No | Organization ID. If not provided, uses the configured org or first available org. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Item Image

**Slug:** `ZOHO_INVENTORY_DELETE_ITEM_IMAGE`

Tool to delete an image associated with an item. Use when you need to remove an item's image after ensuring it's no longer required.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `item_id` | string | Yes | Unique identifier of the item whose image will be deleted |
| `organization_id` | string | No | Organization ID. If not provided, uses the configured org or first available org. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Package

**Slug:** `ZOHO_INVENTORY_DELETE_PACKAGE`

Tool to delete a package. Use when you need to remove an existing package created for a sales order.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `package_id` | string | Yes | Unique identifier of the package to delete |
| `organization_id` | string | No | Organization ID. If not provided, uses the configured org or first available org. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Sales Order

**Slug:** `ZOHO_INVENTORY_DELETE_SALES_ORDER`

Tool to delete a sales order. Use when you need to remove an existing sales order.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `salesorder_id` | string | Yes | Unique identifier of the sales order to delete |
| `organization_id` | string | No | Organization ID. If not provided, uses the configured org or first available org. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Disable Payment Reminder

**Slug:** `ZOHO_INVENTORY_DISABLE_PAYMENT_REMINDER`

Tool to disable payment reminders for an invoice. Use when you want to stop automatic payment reminders for an invoice after it has been issued.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `invoice_id` | string | Yes | Unique identifier of the invoice to disable payment reminders for. |
| `organization_id` | string | No | Organization ID. If not provided, uses the configured org or first available org. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Email Contact

**Slug:** `ZOHO_INVENTORY_EMAIL_CONTACT`

Tool to email a contact in Zoho Inventory. Use when you need to send an email to a specific contact with a custom subject and body.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `body` | string | Yes | Body/content of the email to be sent. Supports HTML formatting. Maximum length 5000 characters. |
| `subject` | string | Yes | Subject of the email to be sent. Maximum length 1000 characters. |
| `contact_id` | string | Yes | Unique identifier of the contact to email. Get this from list contacts or create contact APIs. |
| `to_mail_ids` | array | Yes | List of recipient email addresses to send the email to. At least one email is required. |
| `organization_id` | string | No | Zoho Inventory organization ID. If not provided, uses the configured default or first available organization. |
| `send_customer_statement` | boolean | No | Set to true to include the customer statement PDF as an attachment with the email |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Email Contact Statement

**Slug:** `ZOHO_INVENTORY_EMAIL_CONTACT_STATEMENT`

Tool to email a statement of transactions to a contact. Use when you need to send account statements to customers or vendors.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `body` | string | Yes | Body/content of the email to be sent. Maximum length [5000]. Can include HTML tags. |
| `subject` | string | Yes | Subject of the email to be sent. Maximum length [1000]. |
| `end_date` | string | No | End date for the statement in YYYY-MM-DD format. Must be provided with start_date. |
| `contact_id` | string | Yes | Unique identifier of the contact to send the statement to. |
| `start_date` | string | No | Start date for the statement in YYYY-MM-DD format. If start_date and end_date are not given, current month's statement will be sent. |
| `cc_mail_ids` | array | No | List of email addresses to CC on the statement email. |
| `to_mail_ids` | array | Yes | List of recipient email addresses to send the statement to. At least one email is required. |
| `organization_id` | string | No | Zoho Inventory organization ID. If not provided, uses the configured default or first available organization. |
| `send_from_org_email_id` | boolean | No | Set to true to send the email from the organization's primary email address instead of the user's email. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Email Credit Note

**Slug:** `ZOHO_INVENTORY_EMAIL_CREDIT_NOTE`

Tool to email a credit note to customers. Use when you need to send a credit note via email to recipients.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `body` | string | Yes | Body content of the email. Maximum length: 5000 characters. |
| `subject` | string | Yes | Subject line for the email. Maximum length: 1000 characters. |
| `attachments` | string | No | Files to be attached with the email. |
| `cc_mail_ids` | array | No | List of email addresses to CC on the credit note email. |
| `customer_id` | string | No | Customer ID of the customer for whom the credit note is raised. |
| `to_mail_ids` | array | Yes | List of recipient email addresses to send the credit note to. At least one email is required. |
| `creditnote_id` | string | Yes | Unique identifier of the credit note to be emailed. Get this from list credit notes or create credit note APIs. |
| `organization_id` | string | No | Zoho Inventory organization ID. If not provided, uses the configured default or first available organization. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Email Invoice

**Slug:** `ZOHO_INVENTORY_EMAIL_INVOICE`

Tool to email a specific invoice to customers. Use when you need to send an invoice via email, with optional attachments.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `body` | string | No | Custom email body content. If not provided, uses the default invoice email template configured in Zoho Inventory. |
| `subject` | string | No | Custom email subject line. If not provided, uses the default invoice email subject configured in Zoho Inventory. |
| `invoice_id` | string | Yes | Unique identifier of the invoice to be emailed. Get this from list invoices or create invoice APIs. |
| `attachments` | array | No | Additional files to attach to the email (supports multiple file uploads) |
| `cc_mail_ids` | array | No | List of email addresses to CC on the invoice email |
| `to_mail_ids` | array | Yes | List of recipient email addresses to send the invoice to. At least one email is required. |
| `organization_id` | string | No | Zoho Inventory organization ID. If not provided, uses the configured default or first available organization. |
| `send_attachment` | boolean | No | Set to true to include the default invoice PDF attachment |
| `send_from_org_email_id` | boolean | No | Set to true to send the email from the organization's primary email address instead of the user's email |
| `send_customer_statement` | boolean | No | Set to true to include the customer's statement PDF as an attachment |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Enable Invoice Payment Reminder

**Slug:** `ZOHO_INVENTORY_ENABLE_INVOICE_PAYMENT_REMINDER`

Tool to enable payment reminders for an invoice. Use when you want to activate automatic payment reminders for an invoice after it has been issued.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `invoice_id` | string | Yes | Unique identifier of the invoice to enable payment reminders for. |
| `organization_id` | string | No | Organization ID. If not provided, uses the configured org or first available org. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Contact

**Slug:** `ZOHO_INVENTORY_GET_CONTACT`

Tool to retrieve a specific contact by ID from Zoho Inventory. Use when you need to get detailed information about a customer or vendor contact.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `contact_id` | string | Yes | Unique identifier of the contact to retrieve. |
| `organization_id` | string | No | Zoho Inventory organization ID. If not provided, uses the configured default or first available organization. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Contact Address

**Slug:** `ZOHO_INVENTORY_GET_CONTACT_ADDRESS`

Tool to get contact address. Use when you need to retrieve address information for a specific contact.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `contact_id` | string | Yes | Unique identifier of the contact. |
| `organization_id` | string | No | Organization ID. If not provided, uses the configured org or first available org. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Credit Note

**Slug:** `ZOHO_INVENTORY_GET_CREDIT_NOTE`

Tool to retrieve a credit note by ID. Use when you need to fetch detailed information about a specific credit note.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `print` | boolean | No | Export credit note PDF using the default print option. Set to true to enable PDF export. |
| `accept` | string ("json" | "pdf" | "html") | No | Format for the credit note response. |
| `creditnote_id` | string | Yes | Unique identifier of the credit note to retrieve |
| `organization_id` | string | No | Organization ID. If not provided, uses the configured org or first available org. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Credit Note Email Content

**Slug:** `ZOHO_INVENTORY_GET_CREDIT_NOTE_EMAIL_CONTENT`

Tool to get credit note email content including subject, body, recipients, and available templates. Use when you need to preview or retrieve the email content for a credit note before sending it.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `creditnote_id` | string | Yes | Unique identifier of the credit note. Get this from list credit notes or create credit note APIs. |
| `organization_id` | string | No | Zoho Inventory organization ID. If not provided, uses the configured default or first available organization. |
| `email_template_id` | string | No | Get the email content based on a specific email template. If this param is not inputted, then the content will be based on the email template associated with the customer. If no template is associated with the customer, then default template will be used. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Current User

**Slug:** `ZOHO_INVENTORY_GET_CURRENT_USER`

Tool to get details of the currently authenticated user in Zoho Inventory. Use when you need to retrieve user profile information, permissions, or validate the authenticated user.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `organization_id` | string | No | Zoho Inventory organization ID. If not provided, uses the configured default or first available organization. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Sales Order

**Slug:** `ZOHO_INVENTORY_GET_SALES_ORDER`

Tool to retrieve the details of an existing sales order. Use when you need to get complete information about a sales order including line items, customer details, shipping information, and order status.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `salesorder_id` | string | Yes | Unique identifier of the sales order to retrieve |
| `organization_id` | string | No | Zoho Inventory organization ID. If not provided, uses the configured default or first available organization. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Bills

**Slug:** `ZOHO_INVENTORY_LIST_BILLS`

Tool to list bills. Use when needing to fetch bills for an organization.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number to fetch (minimum 1) |
| `per_page` | integer | No | Number of records per page (minimum 1) |
| `organization_id` | string | No | Organization ID. If not provided, uses the configured org or first available org. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Contacts

**Slug:** `ZOHO_INVENTORY_LIST_CONTACTS`

Tool to list all contacts (customers and vendors) in Zoho Inventory. Use when needing to fetch contacts for an organization.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number to fetch (minimum 1) |
| `per_page` | integer | No | Number of records per page (minimum 1, default 200) |
| `organization_id` | string | No | Organization ID. If not provided, uses the configured org or first available org. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Credit Notes

**Slug:** `ZOHO_INVENTORY_LIST_CREDIT_NOTES`

Tool to list all credit notes. Use when needing to fetch credit notes for an organization. Supports filtering by status, customer, date, and other criteria.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `date` | string | No | The date on which the credit note was raised. Format [yyyy-mm-dd] |
| `page` | integer | No | Page number to be fetched. Default value is 1. |
| `total` | number | No | Total credits raised in this credit note. |
| `status` | string ("open" | "closed" | "void" | "draft") | No | Status of credit note. |
| `tax_id` | string | No | Unique ID to denote the tax associated with the credit note. |
| `item_id` | string | No | Unique string generated for the item for which a refund has to be made. |
| `per_page` | integer | No | Number of records to be fetched per page. Default value is 200. |
| `filter_by` | string ("Status.All" | "Status.Open" | "Status.Draft" | "Status.Closed" | "Status.Void") | No | Filter credit notes by status. |
| `item_name` | string | No | Search credit notes by item name. Max_length [100] |
| `customer_id` | string | No | Customer ID of the customer for whom the credit note is raised. |
| `search_text` | string | No | Search credit notes by credit note number or customer name or credit note reference number. Max-length [100] |
| `sort_column` | string ("customer_name" | "creditnote_number" | "balance" | "total" | "date" | "created_time") | No | Sort column options for credit notes. |
| `line_item_id` | string | No | Search credit notes by credit note line item id. |
| `customer_name` | string | No | Name of the customer to whom the credit note is raised. Max-Length [100] |
| `organization_id` | string | No | Organization ID. If not provided, uses the configured org or first available org. |
| `item_description` | string | No | Description for the item. Variants item_description_startswith and item_description_contains. Max-length [100] |
| `reference_number` | string | No | Reference number generated for the payment. A string of your choice can also be used as the reference number. Max-Length [100] |
| `creditnote_number` | string | No | Unique number generated (starts with CN) which will be displayed in the interface and credit notes. Max-Length [100] |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Currencies

**Slug:** `ZOHO_INVENTORY_LIST_CURRENCIES`

Tool to list all currencies configured in Zoho Inventory. Use when you need to retrieve available currencies, exchange rates, or identify the base currency for an organization.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number to fetch (minimum 1, default 1) |
| `per_page` | integer | No | Number of records per page (minimum 1, default 200) |
| `filter_by` | string ("Currencies.ExcludeBaseCurrency") | No | Filter options for currency listing. |
| `organization_id` | string | No | Organization ID. If not provided, uses the configured org or first available org. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Invoice Payments

**Slug:** `ZOHO_INVENTORY_LIST_INVOICE_PAYMENTS`

Tool to list all payments received for a specific invoice. Use when you need to retrieve payment records for an invoice.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `invoice_id` | string | Yes | Unique identifier of the invoice. |
| `organization_id` | string | No | Organization ID. If not provided, uses the configured org or first available org. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Invoices

**Slug:** `ZOHO_INVENTORY_LIST_INVOICES`

Tool to list all invoices in Zoho Inventory. Use when you need to retrieve invoices for an organization.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number to fetch (minimum 1) |
| `per_page` | integer | No | Number of records per page (minimum 1) |
| `organization_id` | string | No | Organization ID. If not provided, uses the configured org or first available org. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Item Groups

**Slug:** `ZOHO_INVENTORY_LIST_ITEM_GROUPS`

Tool to list all item groups in Zoho Inventory. Use when needing to fetch item groups for an organization. Item groups allow grouping of related items with variations.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number to be fetched. Default value is 1. |
| `per_page` | integer | No | Number of records to be fetched per page. Default value is 200. |
| `organization_id` | string | No | Organization ID. If not provided, uses the configured org or first available org. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Items

**Slug:** `ZOHO_INVENTORY_LIST_ITEMS`

Tool to list all items in Zoho Inventory. Use when you need to retrieve inventory items for an organization.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number to fetch (minimum 1) |
| `per_page` | integer | No | Number of records per page (minimum 1) |
| `organization_id` | string | No | Organization ID. If not provided, uses the configured org or first available org. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Organizations

**Slug:** `ZOHO_INVENTORY_LIST_ORGANIZATIONS`

Tool to list all organizations the user has access to in Zoho Inventory. Use when you need to get organization IDs or view available organizations. This action does not require organization_id as a parameter.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Purchase Orders

**Slug:** `ZOHO_INVENTORY_LIST_PURCHASE_ORDERS`

Tool to list purchase orders. Use when needing to fetch purchase orders for an organization.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number to fetch (minimum 1) |
| `per_page` | integer | No | Number of records per page (minimum 1) |
| `organization_id` | string | No | Organization ID. If not provided, uses the configured org or first available org. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Sales Orders

**Slug:** `ZOHO_INVENTORY_LIST_SALES_ORDERS`

Tool to list sales orders. Use when needing to fetch sales orders for an organization.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number to fetch (minimum 1) |
| `per_page` | integer | No | Number of records per page (minimum 1) |
| `organization_id` | string | No | Organization ID. If not provided, uses the configured org or first available org. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |