# Zoho Invoice

Zoho Invoice simplifies billing, recurring payments, and expense management, helping freelancers and small businesses send professional invoices

- **Category:** proposal & invoice management
- **Auth:** OAUTH2
- **Composio Managed App Available?** Yes
- **Tools:** 137
- **Triggers:** 0
- **Slug:** `ZOHO_INVOICE`
- **Version:** 20260227_00

## Tools

### Add Credit Note to Invoices

**Slug:** `ZOHO_INVOICE_ADD_CREDITNOTE_TO_INVOICES`

Tool to apply a credit note to one or more invoices. Use when you need to apply credits from a credit note to specific invoices. The invoice and credit note must belong to the same customer, and the invoice must not be in closed or paid status.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `invoices` | array | Yes | List of invoices to apply the credit note to. Each invoice must belong to the same customer as the credit note and must not be in closed/paid status. |
| `creditnote_id` | string | Yes | Unique identifier of the credit note to apply to invoices |
| `organization_id` | string | Yes | The Zoho Invoice organization ID (passed as X-com-zoho-invoice-organizationid header) |

#### 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_INVOICE_ADD_INVOICE_COMMENT`

Tool to add a comment to an invoice. Use when you need to add notes or comments to a specific invoice for internal tracking or client communication.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `invoice_id` | string | Yes | Unique identifier of the invoice to add a comment to |
| `description` | string | Yes | The comment text to be added to the invoice |
| `organization_id` | string | Yes | The Zoho Invoice organization ID (sent as X-com-zoho-invoice-organizationid header) |
| `show_comment_to_client` | boolean | No | Boolean to determine whether the comment should be shown to the client |

#### 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 Invoice

**Slug:** `ZOHO_INVOICE_APPLY_CREDITS_TO_INVOICE`

Tool to apply credit notes to an invoice in Zoho Invoice. Use when you need to reduce an invoice balance by applying one or more existing credit notes.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `invoice_id` | string | Yes | Unique identifier of the invoice to which credits will be applied |
| `organization_id` | string | Yes | The Zoho Invoice organization ID (X-com-zoho-invoice-organizationid header) |
| `apply_creditnotes` | array | Yes | List of credit notes to apply to the invoice. Each entry specifies the credit note ID and the amount to apply. |

#### 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 Write Off Invoice

**Slug:** `ZOHO_INVOICE_CANCEL_WRITE_OFF_INVOICE`

Tool to cancel a write-off on an invoice. Use when you need to reverse a previously written-off invoice amount.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `invoice_id` | string | Yes | Unique identifier of the invoice to cancel write-off |
| `organization_id` | string | Yes | The Zoho organization ID. Must be passed as query parameter 'organization_id'. |

#### 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 |

### Clone Zoho Invoice Project

**Slug:** `ZOHO_INVOICE_CLONE_PROJECT`

Tool to clone an existing project. Use when you need to duplicate a project with a new name and description.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `project_id` | string | Yes | Unique identifier of the project to clone |
| `description` | string | No | Description for the cloned project |
| `project_name` | string | Yes | Name of the cloned project |
| `organization_id` | string | Yes | The Zoho Invoice organization ID (X-com-zoho-invoice-organizationid header) |

#### 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 Additional Address

**Slug:** `ZOHO_INVOICE_CREATE_ADDITIONAL_ADDRESS`

Tool to add an additional address to a contact. Use when you need to create a secondary shipping or billing address for an existing contact.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `fax` | string | No | Fax number for this address |
| `zip` | string | No | Postal/ZIP code |
| `city` | string | No | City name |
| `phone` | string | No | Phone number for this address |
| `state` | string | No | State or province name |
| `address` | string | No | Street address line 1 |
| `country` | string | No | Country name |
| `street2` | string | No | Street address line 2 (suite, building, floor, etc.) |
| `attention` | string | No | Contact person name for the address |
| `contact_id` | string | Yes | Unique identifier of the contact to add the address to |
| `state_code` | string | No | State code for the address |
| `organization_id` | string | Yes | The Zoho Invoice organization ID (X-com-zoho-invoice-organizationid header) |

#### 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_INVOICE_CREATE_CONTACT`

Tool to create a contact in Zoho Invoice. Use when you need to add a new customer or vendor to the system.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `notes` | string | No | Comments or notes about the contact |
| `gst_no` | string | No | GST number (India region) |
| `tax_id` | string | No | Tax ID |
| `twitter` | string | No | Twitter profile URL |
| `website` | string | No | Website URL of the contact |
| `facebook` | string | No | Facebook profile URL |
| `legal_name` | string | No | Legal name of the business (Mexico region) |
| `tax_reg_no` | string | No | Tax registration number (Mexico region) |
| `tax_regime` | string | No | Tax regime (Mexico region) |
| `vat_reg_no` | string | No | VAT registration number (UK region) |
| `currency_id` | string | No | Customer's currency identifier |
| `company_name` | string | No | Company name of the contact |
| `contact_name` | string | Yes | Name of the contact. This can be the name of an organization or an individual. |
| `country_code` | string | No | Country code (UK region) |
| `custom_fields` | array | No | Custom fields for the contact |
| `gst_treatment` | string | No | GST treatment type (India region) |
| `language_code` | string | No | Language code for the contact. Allowed values: de, en, es, fr, it, ja, nl, pt, sv, zh |
| `payment_terms` | integer | No | Net payment term for the customer in days |
| `tax_treatment` | string | No | Tax treatment type |
| `vat_treatment` | string | No | VAT treatment type (UK region) |
| `billing_address` | object | No | Billing address details for the contact. |
| `contact_persons` | array | No | List of contact persons associated with this contact |
| `organization_id` | string | Yes | The Zoho organization ID. Required for authentication. |
| `place_of_contact` | string | No | Place of contact (India region) |
| `shipping_address` | object | No | Shipping address details for the contact. |
| `tax_authority_id` | string | No | Tax authority ID |
| `tax_exemption_id` | string | No | Tax exemption ID |

#### 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_INVOICE_CREATE_CONTACT_PERSON`

Tool to create a contact person for an existing contact. Use when you need to add a new contact person to a contact record.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | No | Email address of the contact person |
| `phone` | string | No | Phone number of the contact person |
| `skype` | string | No | Skype ID of the contact person |
| `mobile` | string | No | Mobile number of the contact person |
| `last_name` | string | No | Last name of the contact person |
| `contact_id` | string | Yes | Identifier of the parent contact to which this contact person belongs |
| `department` | string | No | Department in which the contact person works |
| `first_name` | string | Yes | First name of the contact person. Required field. |
| `salutation` | string | No | Salutation for the contact person (e.g., Mr., Ms., Dr.) |
| `designation` | string | No | Job title or designation of the contact person |
| `enable_portal` | boolean | No | Enable portal access for the contact person. Set to true to allow portal login. |
| `organization_id` | string | Yes | The Zoho organization ID. Must be passed as header 'X-com-zoho-invoice-organizationid'. |

#### 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_INVOICE_CREATE_CREDIT_NOTE`

Tool to create a credit note to refund or give credit to a customer. Use when you need to issue a credit for returned items or adjustments.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `date` | string | Yes | Credit note creation date in yyyy-mm-dd format |
| `notes` | string | No | Credit note memo or notes |
| `terms` | string | No | Terms and conditions for the credit note |
| `line_items` | array | Yes | List of items included in the credit note. At least one item is required. |
| `customer_id` | string | Yes | Customer ID of the customer for whom the credit note is raised |
| `organization_id` | string | Yes | The Zoho Invoice organization ID (sent as X-com-zoho-invoice-organizationid header) |
| `reference_number` | string | No | Custom reference number for the credit note |
| `creditnote_number` | string | No | Unique credit note number (starts with CN). If not provided, system auto-generates it. |

#### 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 Comment

**Slug:** `ZOHO_INVOICE_CREATE_CREDIT_NOTE_COMMENT`

Tool to add a comment to a credit note. Use when you need to add notes or comments to an existing credit note.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `description` | string | Yes | The comment text to be added to the credit note |
| `creditnote_id` | string | Yes | Unique identifier of the credit note to add a comment to |
| `organization_id` | string | Yes | The Zoho Invoice organization ID (X-com-zoho-invoice-organizationid header) |

#### 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 Currency

**Slug:** `ZOHO_INVOICE_CREATE_CURRENCY`

Tool to create a new currency in Zoho Invoice. Use when you need to add a currency with specific code, symbol, and formatting options.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `currency_code` | string | Yes | A unique code for the currency (e.g., 'USD', 'EUR', 'AFN') |
| `currency_format` | string | Yes | The format for the currency to be displayed (e.g., '1,234,567.89') |
| `currency_symbol` | string | Yes | A unique symbol for the currency (e.g., '$', '€', '؋') |
| `organization_id` | string | Yes | The Zoho Invoice organization ID (sent as X-com-zoho-invoice-organizationid header) |
| `price_precision` | integer | No | The precision for the price in decimals (e.g., 2 for two decimal places) |

#### 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_INVOICE_CREATE_CUSTOMER_PAYMENT`

Tool to create a customer payment in Zoho Invoice. Use when you need to record a payment made by a customer and apply it to one or more invoices.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `date` | string | Yes | Date of payment in yyyy-mm-dd format |
| `amount` | number | Yes | Total amount paid in the respective payment |
| `invoices` | array | Yes | List of invoices to apply the payment to. Each invoice requires invoice_id and amount_applied |
| `customer_id` | string | Yes | Customer ID of the customer involved in the payment |
| `description` | string | No | Description of the payment |
| `bank_charges` | number | No | Bank charges incurred for the payment |
| `payment_mode` | string ("check" | "cash" | "creditcard" | "banktransfer" | "bankremittance" | "autotransaction" | "others") | Yes | Mode through which payment is made |
| `organization_id` | string | Yes | The Zoho Invoice organization ID (sent as X-com-zoho-invoice-organizationid header) |
| `reference_number` | string | No | Reference number for the payment (max 100 characters) |

#### 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 Employee

**Slug:** `ZOHO_INVOICE_CREATE_EMPLOYEE`

Tool to create an employee in Zoho Invoice. Use when you need to add a new employee to the organization.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Name of the employee |
| `email` | string | Yes | Email address of the employee |
| `organization_id` | string | Yes | ID of the Zoho organization. This will be passed as X-com-zoho-invoice-organizationid header |

#### 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 Estimate

**Slug:** `ZOHO_INVOICE_CREATE_ESTIMATE`

Tool to create a new estimate (quote) for a customer. Use when you need to generate a price quotation before creating an invoice.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `date` | string | No | Estimate date in yyyy-mm-dd format (defaults to current date) |
| `notes` | string | No | Additional notes for the estimate |
| `terms` | string | No | Terms and conditions for the estimate |
| `gst_no` | string | No | GST number (India-specific) |
| `discount` | number | No | Discount value (percentage or amount based on discount_type) |
| `adjustment` | number | No | Adjustment amount (can be positive or negative) |
| `line_items` | array | Yes | List of line items for the estimate (at least one required) |
| `project_id` | string | No | ID of the project associated with this estimate |
| `customer_id` | string | Yes | ID of the customer for whom the estimate is being created |
| `expiry_date` | string | No | Expiry date for the estimate in yyyy-mm-dd format |
| `template_id` | string | No | ID of the template to be used for the estimate |
| `custom_fields` | array | No | List of custom fields for the estimate |
| `discount_type` | string | No | Type of discount: 'entity_level' or 'item_level' |
| `exchange_rate` | number | No | Exchange rate for foreign currency transactions |
| `gst_treatment` | string | No | GST treatment (India-specific) |
| `tax_treatment` | string | No | Tax treatment for the estimate |
| `vat_treatment` | string | No | VAT treatment for the estimate |
| `contact_persons` | array | No | List of contact person IDs associated with this estimate |
| `estimate_number` | string | No | Unique estimate number (auto-generated if not provided) |
| `organization_id` | string | Yes | The Zoho Invoice organization ID (X-com-zoho-invoice-organizationid header) |
| `place_of_supply` | string | No | Place of supply (region-specific, e.g., for GST in India) |
| `shipping_charge` | number | No | Shipping charge amount |
| `is_inclusive_tax` | boolean | No | Whether the line item rates are inclusive of tax |
| `reference_number` | string | No | Reference number for the estimate |
| `salesperson_name` | string | No | Name of the salesperson associated with the estimate |
| `adjustment_description` | string | No | Description for the adjustment |
| `is_discount_before_tax` | boolean | No | Whether discount is 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 |

### Create Estimate Comment

**Slug:** `ZOHO_INVOICE_CREATE_ESTIMATE_COMMENT`

Tool to add a comment to an estimate. Use when you need to add notes or comments to an existing estimate.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `description` | string | Yes | The comment text to add to the estimate |
| `estimate_id` | string | Yes | Unique identifier of the estimate to add the comment to |
| `organization_id` | string | Yes | The Zoho organization ID. Must be passed as query parameter 'organization_id' |

#### 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 Exchange Rate

**Slug:** `ZOHO_INVOICE_CREATE_EXCHANGE_RATE`

Tool to create an exchange rate for a specified currency. Use when you need to set or update the exchange rate for a currency with respect to the base currency, effective from a specific date.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `rate` | number | Yes | Rate of exchange for the currency with respect to base currency |
| `currency_id` | string | Yes | Unique identifier of the currency for which to create the exchange rate |
| `effective_date` | string | Yes | Date from when the exchange rate will be in effect (format: YYYY-MM-DD) |
| `organization_id` | string | Yes | The Zoho Invoice organization ID (X-com-zoho-invoice-organizationid header) |

#### 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 Expense Category

**Slug:** `ZOHO_INVOICE_CREATE_EXPENSE_CATEGORY`

Tool to create a new expense category in Zoho Invoice. Use when you need to add a new expense category for tracking business expenses.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `description` | string | No | Describe the expense category |
| `account_name` | string | Yes | Account name of the expense category |
| `organization_id` | string | Yes | The Zoho Invoice organization ID (X-com-zoho-invoice-organizationid header) |

#### 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_INVOICE_CREATE_INVOICE`

Tool to create a new invoice for a customer in Zoho Invoice. Use when you need to bill a customer with line items and pricing details.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `date` | string | Yes | Invoice date in yyyy-mm-dd format |
| `notes` | string | No | The notes added below expressing gratitude or payment instructions |
| `terms` | string | No | Terms and conditions of the invoice |
| `discount` | number | No | Discount applied to the invoice |
| `due_date` | string | No | Due date of the invoice in yyyy-mm-dd format |
| `adjustment` | number | No | Adjustment amount applied to the invoice |
| `line_items` | array | Yes | Line items of the invoice. At least one line item is required. |
| `project_id` | string | No | ID of the project associated with the invoice |
| `customer_id` | string | Yes | ID of the customer to whom the invoice is created |
| `template_id` | string | No | ID of the PDF template associated with the invoice |
| `custom_fields` | array | No | Custom fields for the invoice |
| `payment_terms` | integer | No | Payment terms in days (e.g., 15, 30, 60) |
| `invoice_number` | string | No | An unique number given to the invoice. If not specified, system will generate automatically. |
| `organization_id` | string | Yes | The Zoho Invoice organization ID (sent as X-com-zoho-invoice-organizationid header) |
| `shipping_charge` | number | No | Shipping charges applied to the invoice |
| `reference_number` | string | No | The reference number of the invoice |
| `salesperson_name` | string | No | Name of the salesperson |
| `adjustment_description` | string | No | Description for the adjustment applied to 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_INVOICE_CREATE_ITEM`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `sku` | string | No | Stock Keeping Unit (SKU) code. Must be unique across products. |
| `name` | string | Yes | Name of the item. Maximum length: 100 characters. |
| `rate` | number | Yes | Per unit price of the item |
| `tax_id` | string | No | ID of the tax to be associated with the item |
| `hsn_or_sac` | string | No | HSN (Harmonized System of Nomenclature) or SAC (Services Accounting Code). India only. |
| `is_taxable` | boolean | No | Whether the item is taxable. Applicable for US, Canada, and India only. |
| `description` | string | No | Description of the item. Maximum length: 2000 characters. |
| `product_type` | string | No | Type of item: 'goods' or 'service' |
| `unitkey_code` | string | No | Unit Key Code from CFDI Catalogs. Mexico only. |
| `custom_fields` | array | No | List of custom fields with customfield_id and value |
| `organization_id` | string | Yes | The Zoho Invoice organization ID (X-com-zoho-invoice-organizationid header) |
| `tax_exemption_id` | string | No | Tax exemption ID. Required if is_taxable is false. Applicable for US, Canada, and India only. |
| `sat_item_key_code` | string | No | SAT Item Key Code from CFDI Catalogs. Mexico only. |
| `item_tax_preferences` | array | No | List of tax preferences with tax_id and tax_specification (intra/inter for India) |

#### 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 Project Comment

**Slug:** `ZOHO_INVOICE_CREATE_PROJECT_COMMENT`

Tool to post a comment to a project. Use when you need to add comments or notes to a specific project.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `project_id` | string | Yes | Unique identifier of the project |
| `description` | string | Yes | A short note on the project details. Maximum length: 500 characters |
| `organization_id` | string | Yes | The Zoho Invoice organization ID (X-com-zoho-invoice-organizationid header) |

#### 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 Recurring Invoice

**Slug:** `ZOHO_INVOICE_CREATE_RECURRING_INVOICE`

Tool to create a recurring invoice profile that automatically generates invoices at specified intervals. Use when you need to set up automatic invoice generation for subscriptions or regular billing.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | No | Email address of the customer |
| `gst_no` | string | No | India only: 15-digit GST number |
| `end_date` | string | No | When the recurring invoice expires (yyyy-mm-dd format) |
| `cfdi_usage` | string ("acquisition_of_merchandise" | "general_expense" | "donation" | "construction" | "office_furniture" | "transportation_equipment" | "computer_equipment" | "delivery_equipment" | "tooling" | "telephone_equipment" | "medical_expenses") | No | Mexico CFDI usage options. |
| `line_items` | array | No | Invoice items with quantity, rate, taxes, and discounts |
| `start_date` | string | No | When the recurring invoice begins (yyyy-mm-dd format) |
| `customer_id` | string | Yes | ID of the customer for whom the recurring invoice is created |
| `repeat_every` | integer | No | Period between recurrency occurrences (e.g., 1 for every frequency, 2 for every 2 frequencies) |
| `custom_fields` | array | No | List of custom fields for the recurring invoice |
| `gst_treatment` | string ("business_gst" | "business_none" | "overseas" | "consumer") | No | India GST treatment options. |
| `tax_treatment` | string ("home_country_mexico" | "border_region_mexico" | "non_mexico") | No | Mexico tax treatment options. |
| `vat_treatment` | string ("uk" | "eu_vat_registered" | "overseas") | No | UK VAT treatment options. |
| `avatax_use_code` | string | No | Avalara only: Custom tax rule grouping code (max 25 characters) |
| `contact_persons` | array | No | List of contact person IDs associated with the customer |
| `organization_id` | string | Yes | The Zoho Invoice organization ID (passed as X-com-zoho-invoice-organizationid header) |
| `place_of_supply` | string | No | India only: Location where goods/services are supplied |
| `recurrence_name` | string | Yes | Unique name for the recurring invoice profile (max 100 characters) |
| `avatax_exempt_no` | string | No | Avalara only: Tax exemption certificate number (max 25 characters) |
| `payment_gateways` | array | No | List of payment gateway configurations |
| `reference_number` | string | No | Order number or reference for the recurring invoice |
| `tax_authority_id` | string | No | US/Canada only: Location-based tax authority identifier |
| `tax_exemption_id` | string | No | India/US/Canada only: Tax exemption identifier |
| `recurrence_frequency` | string ("weeks" | "months" | "days" | "years") | Yes | Interval pattern for invoice generation (weeks, months, days, or years) |
| `allow_partial_payments` | boolean | No | Mexico only: Allow partial payments (PPU vs PPD payment structure) |

#### 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 Refund Credit Note Refunds

**Slug:** `ZOHO_INVOICE_CREATE_REFUND_CREDIT_NOTE_REFUNDS`

Tool to create a refund for a credit note. Use when you need to refund credit note amount to a customer.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `date` | string | Yes | Date of the refund in YYYY-MM-DD format |
| `amount` | number | Yes | Refund amount (must be greater than 0 and less than or equal to credit note balance) |
| `description` | string | No | Description of the refund |
| `refund_mode` | string | Yes | Mode of refund (e.g., cash, check, bank_transfer, credit_card) |
| `creditnote_id` | string | Yes | Unique identifier of the credit note to create a refund for |
| `organization_id` | string | Yes | Organization ID header required for multi-org accounts (X-com-zoho-invoice-organizationid) |
| `reference_number` | string | No | Reference number for the refund |

#### 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 Task

**Slug:** `ZOHO_INVOICE_CREATE_TASK`

Tool to create a new task in a Zoho Invoice project. Use when you need to add a task to an existing project with task name and optional details like description, hourly rate, and budget hours.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `rate` | integer | No | Hourly rate for the task. Must be a non-negative integer. |
| `task_name` | string | Yes | The name of the task. Maximum length is 100 characters. |
| `project_id` | string | Yes | Unique identifier of the project to which the task belongs. |
| `description` | string | No | The description of the task. Provides additional details about what the task involves. |
| `budget_hours` | integer | No | Task budget hours. Total hours allocated for completing this task. Must be a non-negative integer. |
| `organization_id` | string | Yes | The Zoho Invoice organization ID (X-com-zoho-invoice-organizationid header). |

#### 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 Tax

**Slug:** `ZOHO_INVOICE_CREATE_TAX`

Tool to create a new tax in Zoho Invoice. Use when you need to add a tax rate that can be applied to items and invoices.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tax_name` | string | Yes | Name of the tax to be created |
| `tax_type` | string ("tax" | "compound_tax") | Yes | Type of tax: 'tax' for regular tax or 'compound_tax' for compound tax |
| `tax_factor` | string ("rate" | "share") | No | Tax factor (Mexico only). |
| `country_code` | string | No | Two-letter country code (UK only) |
| `tax_account_id` | string | No | Tax account ID for withholding tax (Mexico only) |
| `tax_percentage` | number | Yes | Percentage rate for the tax |
| `organization_id` | string | Yes | The Zoho Invoice organization ID (X-com-zoho-invoice-organizationid header) |
| `tax_authority_id` | string | No | Unique identifier of the tax authority |
| `tax_specific_type` | string ("igst" | "cgst" | "sgst" | "nil" | "cess" | "isr" | "iva" | "ieps") | No | Tax specific type for region-specific taxes. |
| `purchase_tax_account_id` | string | No | Purchase tax account ID for withholding tax (Mexico 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 |

### Create Tax Group

**Slug:** `ZOHO_INVOICE_CREATE_TAX_GROUP`

Tool to create a new tax group in Zoho Invoice. Use when you need to combine multiple taxes into a single group for easier application to invoices and items.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `taxes` | string | Yes | Comma-separated list of tax IDs to be associated to the tax group (e.g., '3476910000000098199,3476910000000098207') |
| `tax_group_name` | string | Yes | Name of the tax group to be created |
| `organization_id` | string | Yes | The Zoho Invoice organization ID. Required for multi-organization accounts. |

#### 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 Time Entry

**Slug:** `ZOHO_INVOICE_CREATE_TIME_ENTRY`

Tool to log time entries for projects in Zoho Invoice. Use when you need to track billable or non-billable hours against a project or task.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `notes` | string | No | Notes or description for the time entry |
| `task_id` | string | No | Task ID within the project |
| `user_id` | string | No | User ID who logged the time |
| `end_time` | string | No | End time in HH:MM format (24-hour). Use with begin_time instead of log_time. |
| `log_date` | string | Yes | Date of the time entry in YYYY-MM-DD format |
| `log_time` | string | No | Logged time duration (e.g., '2:00' for 2 hours). Either provide log_time OR both begin_time and end_time, not both. |
| `begin_time` | string | No | Start time in HH:MM format (24-hour). Use with end_time instead of log_time. |
| `project_id` | string | Yes | ID or name of the project to log time against |
| `is_billable` | boolean | No | Whether the time entry is billable to the customer |
| `organization_id` | string | Yes | The Zoho Invoice organization ID (X-com-zoho-invoice-organizationid header) |

#### 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 Zoho Invoice User

**Slug:** `ZOHO_INVOICE_CREATE_USER`

Tool to create a new user in Zoho Invoice. Use when you need to add a user to an organization. The user will receive an invitation email.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Name of the user to be created |
| `email` | string | Yes | Email address of the user (must be unique) |
| `user_role` | string | No | Role assignment for the user (e.g., 'admin', 'staff', 'timesheetstaff'). If not specified, default role will be assigned. |
| `organization_id` | string | Yes | The Zoho Invoice organization ID (X-com-zoho-invoice-organizationid header) |

#### 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 Additional Address

**Slug:** `ZOHO_INVOICE_DELETE_ADDITIONAL_ADDRESS`

Tool to delete an additional address from a contact. Use when you need to remove a specific address from a contact's address list.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `address_id` | string | Yes | Unique identifier of the address to delete. |
| `contact_id` | string | Yes | Unique identifier of the contact. |
| `organization_id` | string | Yes | The Zoho organization ID. Must be passed as query parameter 'organization_id'. |

#### 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_INVOICE_DELETE_CONTACT`

Tool to delete a contact from Zoho Invoice. Use when you need to permanently remove a contact from the system.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `contact_id` | string | Yes | Unique identifier of the contact to delete. |
| `organization_id` | string | Yes | The Zoho organization ID. Must be passed as query parameter 'organization_id'. |

#### 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_INVOICE_DELETE_CONTACT_PERSON`

Tool to delete a contact person from Zoho Invoice. Use when you need to remove a specific contact person from the system.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `organization_id` | string | Yes | The Zoho organization ID. Must be passed as header 'X-com-zoho-invoice-organizationid'. |
| `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 Credit Notes Applied to Invoice

**Slug:** `ZOHO_INVOICE_DELETE_CREDIT_NOTES_APPLIED_TO_INVOICE`

Tool to delete invoices credited from a credit note. Use when you need to remove an invoice that was previously credited by a credit note.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `creditnote_id` | string | Yes | Unique identifier of the credit note. |
| `organization_id` | string | Yes | Organization ID to which the credit note belongs. Required when user belongs to multiple organizations. |
| `creditnote_invoice_id` | string | Yes | Unique identifier of the credit note invoice to be removed. |

#### 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 Currency

**Slug:** `ZOHO_INVOICE_DELETE_CURRENCY`

Tool to delete a currency from Zoho Invoice settings. Use when you need to permanently remove a currency from the system.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `currency_id` | string | Yes | Unique identifier of the currency to delete. |
| `organization_id` | string | Yes | The Zoho Invoice organization ID. Required to identify which organization the currency belongs to. |

#### 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 Customer Payment

**Slug:** `ZOHO_INVOICE_DELETE_CUSTOMER_PAYMENT`

Tool to delete an existing payment from Zoho Invoice. Use when you need to remove a specific customer payment from the system.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `payment_id` | string | Yes | Unique identifier of the payment to delete. |
| `organization_id` | string | Yes | The Zoho organization ID. Must be passed as header 'X-com-zoho-invoice-organizationid'. |

#### 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 Employee

**Slug:** `ZOHO_INVOICE_DELETE_EMPLOYEE`

Tool to delete an employee from Zoho Invoice. Use when you need to permanently remove an employee from the system.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `employee_id` | string | Yes | Unique identifier of the employee to delete. |
| `organization_id` | string | Yes | The Zoho organization ID. Must be passed as header 'X-com-zoho-invoice-organizationid'. |

#### 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 Estimate Comment

**Slug:** `ZOHO_INVOICE_DELETE_ESTIMATE_COMMENT`

Tool to delete a comment from an estimate. Use when you need to remove a specific comment from an existing estimate.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `comment_id` | string | Yes | Unique identifier of the comment to delete. |
| `estimate_id` | string | Yes | Unique identifier of the estimate. |
| `organization_id` | string | Yes | The Zoho Invoice organization ID. Required when user belongs to multiple organizations. |

#### 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 Estimates

**Slug:** `ZOHO_INVOICE_DELETE_ESTIMATES`

Tool to delete one or more estimates (quotes). Use when you need to permanently remove estimates from the system. This is a bulk delete operation that can delete multiple estimates at once.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `estimate_ids` | string | Yes | Comma-separated list of estimate IDs to delete. Can be a single ID or multiple IDs (e.g., '3476910000000099368' or '123,456,789'). |
| `organization_id` | string | Yes | The Zoho Invoice organization ID. Required when user belongs to multiple organizations. |

#### 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 Expense

**Slug:** `ZOHO_INVOICE_DELETE_EXPENSE`

Tool to delete an expense from Zoho Invoice. Use when you need to permanently remove an expense from the system.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `expense_id` | string | Yes | Unique identifier of the expense to delete. |
| `organization_id` | string | Yes | The Zoho organization ID. Must be passed as header 'X-com-zoho-invoice-organizationid'. |

#### 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 Expense Category

**Slug:** `ZOHO_INVOICE_DELETE_EXPENSE_CATEGORY`

Tool to delete an expense category from Zoho Invoice. Use when you need to permanently remove an expense category. Note: Categories associated with expenses cannot be deleted.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `category_id` | string | Yes | Unique identifier of the expense category to delete. |
| `organization_id` | string | Yes | The Zoho Invoice organization ID. Required when user belongs to multiple organizations. |

#### 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_INVOICE_DELETE_INVOICE`

Tool to delete an existing invoice from Zoho Invoice. Use when you need to permanently remove an invoice. Invoices with payments or credit notes applied cannot be deleted.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `invoice_id` | string | Yes | Unique identifier of the invoice to delete. |
| `organization_id` | string | Yes | The Zoho Invoice organization ID. Required when user belongs to multiple organizations. |

#### 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_INVOICE_DELETE_INVOICE_ATTACHMENT`

Tool to delete an attachment from an invoice. Use when you need to remove a document or file from a Zoho Invoice.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `invoice_id` | string | Yes | Unique identifier of the invoice. |
| `organization_id` | string | Yes | The Zoho Invoice organization ID (X-com-zoho-invoice-organizationid header). |

#### 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_INVOICE_DELETE_INVOICE_COMMENT`

Tool to delete a comment from an invoice. Use when you need to remove a specific comment from an existing invoice.

#### 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 | Yes | The Zoho Invoice organization ID. Required when user belongs to multiple organizations. |

#### 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 Expense Receipt

**Slug:** `ZOHO_INVOICE_DELETE_INVOICE_EXPENSE_RECEIPT`

Tool to delete the receipt attached to an expense in Zoho Invoice. Use when you need to remove the receipt file from an expense while keeping the expense itself.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `expense_id` | string | Yes | Unique identifier of the expense whose receipt should be deleted. |
| `organization_id` | string | Yes | The Zoho Invoice organization ID. Required as query 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 |

### Delete Item

**Slug:** `ZOHO_INVOICE_DELETE_ITEM`

Tool to delete an existing item from Zoho Invoice. Items that are part of a transaction cannot be deleted and will return an error.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `item_id` | string | Yes | Unique ID of the item to delete |
| `organization_id` | string | Yes | The Zoho Invoice organization ID (X-com-zoho-invoice-organizationid header) |

#### 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 Project

**Slug:** `ZOHO_INVOICE_DELETE_PROJECT`

Tool to delete a project from Zoho Invoice. Use when you need to permanently remove a project from the system.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `project_id` | string | Yes | Unique identifier of the project to delete |
| `organization_id` | string | Yes | The Zoho Invoice organization ID (X-com-zoho-invoice-organizationid header) |

#### 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 Project Comment

**Slug:** `ZOHO_INVOICE_DELETE_PROJECT_COMMENT`

Tool to delete a comment from a project. Use when you need to remove a specific comment from an existing project.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `comment_id` | string | Yes | Unique identifier of the comment to delete. |
| `project_id` | string | Yes | Unique identifier of the project. |
| `organization_id` | string | Yes | The Zoho Invoice organization ID. Required when user belongs to multiple organizations. |

#### 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 Tax

**Slug:** `ZOHO_INVOICE_DELETE_SETTING_TAXES`

Tool to delete a simple or compound tax from Zoho Invoice settings. Use when you need to permanently remove a tax from the system.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tax_id` | string | Yes | Unique identifier of the tax to delete. |
| `organization_id` | string | Yes | The Zoho Invoice organization ID. Required to identify which organization the tax belongs to. |

#### 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 Task

**Slug:** `ZOHO_INVOICE_DELETE_TASK`

Tool to delete a task from a Zoho Invoice project. Use when you need to permanently remove a task from a project.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `task_id` | string | Yes | Unique identifier of the task to delete. |
| `project_id` | string | Yes | Unique identifier of the project. |
| `organization_id` | string | Yes | The Zoho Invoice organization ID. Must be passed as query parameter 'organization_id'. |

#### 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 Time Entry

**Slug:** `ZOHO_INVOICE_DELETE_TIME_ENTRY`

Tool to delete a time entry from Zoho Invoice. Use when you need to permanently remove a time entry from a project.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `time_entry_id` | string | Yes | Unique identifier of the time entry to delete. |
| `organization_id` | string | Yes | The Zoho organization ID. Must be passed as header 'X-com-zoho-invoice-organizationid'. |

#### 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 User

**Slug:** `ZOHO_INVOICE_DELETE_USER`

Tool to delete a user from Zoho Invoice. Use when you need to permanently remove a user from an organization.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `user_id` | string | Yes | Unique identifier of the user to delete. |
| `organization_id` | string | Yes | The Zoho organization ID. Must be passed as header 'X-com-zoho-invoice-organizationid'. |

#### 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 Contact Payment Reminders

**Slug:** `ZOHO_INVOICE_DISABLE_CONTACT_PAYMENT_REMINDERS`

Tool to disable payment reminders for a contact. Use when you need to stop automatic payment reminder notifications for all invoices associated with a specific contact.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `contact_id` | string | Yes | Unique identifier of the contact to disable payment reminders for |
| `organization_id` | string | Yes | The Zoho organization ID. Required for all Zoho Invoice API calls (sent as X-com-zoho-invoice-organizationid header). |

#### 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 Invoice Payment Reminder

**Slug:** `ZOHO_INVOICE_DISABLE_INVOICE_PAYMENT_REMINDER`

Tool to disable payment reminders for an invoice. Use when you need to stop automatic payment reminder notifications for a specific invoice.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `invoice_id` | string | Yes | Unique identifier of the invoice to disable payment reminders for |
| `organization_id` | string | Yes | The Zoho organization ID. Required for all Zoho Invoice API calls (sent as X-com-zoho-invoice-organizationid header). |

#### 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_INVOICE_EMAIL_CONTACT_STATEMENT`

Tool to email a statement to a contact in Zoho Invoice. Use when you need to send account statements showing transaction history for a specific period to a customer or vendor.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `end_date` | string | No | End date for the statement period. Date format: yyyy-mm-dd |
| `contact_id` | string | Yes | Unique identifier of the contact to send the statement to. |
| `start_date` | string | No | Start date for the statement period. If start_date and end_date are not provided, the current month's statement will be sent. Date format: yyyy-mm-dd |
| `organization_id` | string | Yes | The Zoho organization ID. Required for authentication. |

#### 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 Estimate

**Slug:** `ZOHO_INVOICE_EMAIL_ESTIMATE`

Tool to email an estimate to a customer. Use when you need to send an estimate via email to one or more recipients.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `body` | string | No | Body content of the email. If not provided, a default template will be used. |
| `subject` | string | No | Subject line for the email. If not provided, a default subject will be used. |
| `cc_mail_ids` | array | No | List of email addresses to CC on the estimate email. |
| `estimate_id` | string | Yes | Unique identifier of the estimate to email. |
| `to_mail_ids` | array | Yes | List of recipient email addresses. At least one email address is required. |
| `organization_id` | string | Yes | The Zoho Invoice organization ID. Required for all Zoho Invoice API calls. |
| `send_from_org_email_id` | boolean | No | Whether to send the email from the organization's email address. 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 |

### Email Invoice

**Slug:** `ZOHO_INVOICE_EMAIL_INVOICE`

Tool to email an invoice to customers. Use when you need to send an invoice via email to one or more recipients with optional CC recipients and custom email content.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `body` | string | No | Body content of the email. If not provided, default template will be used. |
| `subject` | string | No | Subject of the email. If not provided, default subject will be used. |
| `invoice_id` | string | Yes | Unique identifier of the invoice to email |
| `cc_mail_ids` | array | No | Array of email addresses to be CC'd |
| `to_mail_ids` | array | Yes | Array of email addresses of the recipients. At least one email address is required. |
| `organization_id` | string | Yes | The Zoho Invoice organization ID (sent as query parameter) |
| `send_attachment` | boolean | No | Send the invoice attachment along with the email |
| `send_from_org_email_id` | boolean | No | Boolean to trigger email from organization's email address instead of default sender |
| `send_customer_statement` | boolean | No | Send customer statement PDF along 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 Multiple Estimates

**Slug:** `ZOHO_INVOICE_EMAIL_MULTIPLE_ESTIMATES`

Tool to send estimates via email to customers in bulk. Use when you need to email multiple estimates at once to their respective customers.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `estimate_ids` | string | Yes | Comma-separated estimate IDs to be emailed. Example: '3476910000000098112,3476910000000098113' |
| `organization_id` | string | Yes | The Zoho organization ID. Required when user belongs to multiple organizations. |

#### 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_INVOICE_ENABLE_INVOICE_PAYMENT_REMINDER`

Tool to enable payment reminders for an invoice. Use when you need to activate automatic payment reminder notifications for a specific invoice.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `invoice_id` | string | Yes | Unique identifier of the invoice to enable payment reminders for |
| `organization_id` | string | Yes | The Zoho organization ID. Required for all Zoho Invoice API calls (sent as X-com-zoho-invoice-organizationid header). |

#### 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 Payment Reminders

**Slug:** `ZOHO_INVOICE_ENABLE_PAYMENT_REMINDERS`

Tool to enable payment reminders for a contact. Use when you need to activate automatic payment reminder notifications for a specific contact.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `contact_id` | string | Yes | Unique identifier of the contact to enable payment reminders for |
| `organization_id` | string | Yes | The Zoho organization ID. Required for all Zoho Invoice API calls (sent as X-com-zoho-invoice-organizationid header). |

#### 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 Portal Access

**Slug:** `ZOHO_INVOICE_ENABLE_PORTAL_ACCESS`

Tool to enable portal access for contact persons in Zoho Invoice. Use when you need to grant customer portal access to specific contact persons.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `contact_id` | string | Yes | Unique identifier of the contact for which to enable portal access |
| `contact_persons` | array | Yes | Array of contact person objects containing contact_person_id. At least one contact person is required. |
| `organization_id` | string | Yes | The Zoho organization ID. Required for authentication. |

#### 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_INVOICE_EXPORT_INVOICES_BULK`

Tool to bulk export multiple invoices as a single PDF file. Use when you need to download invoices in PDF format for multiple invoice IDs at once.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `invoice_ids` | string | Yes | Comma-separated invoice IDs to export as PDF (e.g., '3476910000000097030,3476910000000082362') |
| `organization_id` | string | Yes | The Zoho Invoice organization ID. Required to identify 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 |

### Get All Tasks

**Slug:** `ZOHO_INVOICE_GET_ALL_TASKS`

Tool to list all tasks in a Zoho Invoice project. Use when you need to retrieve tasks for a specific project with optional pagination.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for pagination, starting from 1. Default is 1. |
| `per_page` | integer | No | Number of tasks per page (max 200). Default is 200. |
| `project_id` | string | Yes | Unique identifier of the project to list tasks from. |
| `organization_id` | string | Yes | The Zoho Invoice organization ID. Required when user belongs to multiple organizations. |

#### 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 Client Review

**Slug:** `ZOHO_INVOICE_GET_CLIENT_REVIEW`

Tool to retrieve details of a particular client review by comment ID. Use when you need to fetch a specific client review or feedback from Zoho Invoice.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `comment_id` | string | Yes | Unique identifier of the client review (comment) to retrieve. |
| `contact_id` | string | No | Unique ID of a particular contact to filter the review by. |
| `organization_id` | string | Yes | The Zoho Invoice organization ID. Must be passed as query parameter 'organization_id'. |

#### 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_INVOICE_GET_CONTACT`

Tool to retrieve a specific contact by ID. Use when you need to fetch detailed information about a customer or vendor.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `contact_id` | string | Yes | Unique identifier of the contact to retrieve. |
| `organization_id` | string | Yes | The Zoho organization ID. Required for authentication. |

#### 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 Addresses

**Slug:** `ZOHO_INVOICE_GET_CONTACT_ADDRESSES`

Tool to retrieve all addresses for a contact. Use when you need to fetch shipping or billing addresses associated with a specific contact.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `contact_id` | string | Yes | Unique identifier of the contact. |
| `organization_id` | string | Yes | The Zoho organization ID. Must be passed as query parameter 'organization_id'. |

#### 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 Person

**Slug:** `ZOHO_INVOICE_GET_CONTACT_PERSON`

Tool to retrieve details of a specific contact person. Use when you need to fetch information about a contact person associated with a contact.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `contact_id` | string | Yes | Unique identifier of the contact. |
| `organization_id` | string | Yes | The Zoho organization ID. Required when user belongs to multiple organizations. |
| `contact_person_id` | string | Yes | Unique identifier of 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 |

### Get Credit Note

**Slug:** `ZOHO_INVOICE_GET_CREDIT_NOTE`

Tool to retrieve the details of a specific credit note by creditnote_id. Use when you need to fetch a credit note's information after confirming its existence.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `print` | boolean | No | Export credit note pdf with default print option |
| `accept` | string ("json" | "pdf" | "html") | No | Format for credit note response. |
| `creditnote_id` | string | Yes | Unique identifier of the credit note to retrieve |
| `organization_id` | string | Yes | The Zoho Invoice organization ID (sent as X-com-zoho-invoice-organizationid header) |

#### 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 History

**Slug:** `ZOHO_INVOICE_GET_CREDIT_NOTE_EMAIL_HISTORY`

Tool to retrieve email history for a credit note. Use when you need to see all emails sent for a specific credit note.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `creditnote_id` | string | Yes | Unique identifier of the credit note. |
| `organization_id` | string | Yes | The Zoho Invoice organization ID (sent as X-com-zoho-invoice-organizationid header). |

#### 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 Refund

**Slug:** `ZOHO_INVOICE_GET_CREDIT_NOTE_REFUND`

Tool to retrieve details of a specific credit note refund. Use when you need to fetch refund information by credit note ID and refund ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `creditnote_id` | string | Yes | Unique identifier of the credit note. |
| `organization_id` | string | Yes | The Zoho Invoice organization ID. Required when user belongs to multiple organizations. |
| `creditnote_refund_id` | string | Yes | Unique identifier of the credit note refund. |

#### 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 Expense

**Slug:** `ZOHO_INVOICE_GET_EXPENSE`

Tool to retrieve a specific expense by ID. Use when you need to fetch detailed information about an expense record.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `expense_id` | string | Yes | Unique identifier of the expense to retrieve. |
| `organization_id` | string | Yes | The Zoho organization ID. Required for authentication. |

#### 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 Invoice

**Slug:** `ZOHO_INVOICE_GET_INVOICE`

Tool to retrieve the details of a specific invoice by invoice_id. Use when you need to fetch an invoice's information after confirming its existence.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `invoice_id` | string | Yes | Unique identifier of the invoice to retrieve |
| `organization_id` | string | Yes | The Zoho Invoice organization ID (sent as X-com-zoho-invoice-organizationid header) |

#### 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 Invoice Attachment

**Slug:** `ZOHO_INVOICE_GET_INVOICE_ATTACHMENT`

Tool to get invoice attachment details. Use when you need to retrieve information about files attached to a Zoho Invoice.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `preview` | boolean | No | Get the thumbnail of the attachment. |
| `invoice_id` | string | Yes | Unique identifier of the invoice. |
| `organization_id` | string | Yes | The Zoho Invoice organization ID. |

#### 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 Invoice Email Content

**Slug:** `ZOHO_INVOICE_GET_INVOICE_EMAIL_CONTENT`

Tool to retrieve the email content for a specific invoice. Use when you need to fetch the email subject, body, and recipients that would be used when emailing an invoice.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `invoice_id` | string | Yes | Unique identifier of the invoice to get email content for |
| `organization_id` | string | Yes | The Zoho Invoice organization ID (sent as X-com-zoho-invoice-organizationid header) |
| `email_template_id` | string | No | Get the email content based on a specific email template. If not provided, 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 Zoho Invoice Item

**Slug:** `ZOHO_INVOICE_GET_ITEM`

Tool to retrieve the details of a specific item by item_id. Use when you need to fetch an item's data after confirming its existence.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `item_id` | string | Yes | Unique ID of the item to retrieve |
| `organization_id` | string | Yes | The Zoho Invoice organization ID (X-com-zoho-invoice-organizationid header) |

#### 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 Payment Reminder Mail Content

**Slug:** `ZOHO_INVOICE_GET_PAYMENT_REMINDER_MAIL_CONTENT`

Tool to retrieve payment reminder mail content for a specific invoice. Use when you need to fetch the email subject, body, and settings for sending payment reminder emails.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `invoice_id` | string | Yes | Unique identifier of the invoice to retrieve payment reminder mail content for. |
| `organization_id` | string | Yes | The Zoho Invoice organization ID. This is required to identify which organization's data to retrieve. |

#### 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 Price List

**Slug:** `ZOHO_INVOICE_GET_PRICE_LIST`

Tool to retrieve the details of a specific price list by pricebook_id. Use when you need to fetch pricing information for items.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `pricebook_id` | string | Yes | Unique identifier of the price list to retrieve |
| `organization_id` | string | Yes | The Zoho Invoice organization ID (sent as X-com-zoho-invoice-organizationid header) |

#### 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 Project

**Slug:** `ZOHO_INVOICE_GET_PROJECT`

Tool to retrieve details of a specific project by project ID. Use when you need to fetch project information including tasks, users, and billing details.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `project_id` | string | Yes | Unique identifier of the project to retrieve |
| `organization_id` | string | Yes | The Zoho Invoice organization ID (X-com-zoho-invoice-organizationid header) |

#### 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 Project User

**Slug:** `ZOHO_INVOICE_GET_PROJECT_USER`

Tool to retrieve a specific user from a project. Use when you need to fetch details about a user assigned to a project.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `user_id` | string | Yes | Unique identifier of the user. |
| `project_id` | string | Yes | Unique identifier of the project. |
| `organization_id` | string | Yes | The Zoho Invoice organization ID. Required for authentication. |

#### 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 Recurring Invoice

**Slug:** `ZOHO_INVOICE_GET_RECURRING_INVOICE`

Tool to retrieve the details of a specific recurring invoice by recurring_invoice_id. Use when you need to fetch a recurring invoice's information.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `organization_id` | string | Yes | The Zoho Invoice organization ID (sent as X-com-zoho-invoice-organizationid header) |
| `recurring_invoice_id` | string | Yes | Unique identifier of the recurring invoice to retrieve |

#### 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 Statement Mail Content

**Slug:** `ZOHO_INVOICE_GET_STATEMENT_MAIL_CONTENT`

Tool to retrieve statement mail content for a specific contact. Use when you need to fetch the email subject, body, and settings for sending statement emails to customers or vendors.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `end_date` | string | No | End date for the statement period. Date format: yyyy-mm-dd |
| `contact_id` | string | Yes | Unique identifier of the contact to retrieve statement mail content for. |
| `start_date` | string | No | Start date for the statement period. If start_date and end_date are not given, current month's statement will be used. Date format: yyyy-mm-dd |
| `organization_id` | string | Yes | The Zoho Invoice organization ID. This is required to identify which organization's data to retrieve. |

#### 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 Task

**Slug:** `ZOHO_INVOICE_GET_TASK`

Tool to retrieve a specific task from a Zoho Invoice project. Use when you need to fetch detailed information about a task using its ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `task_id` | string | Yes | Unique identifier of the task to retrieve. |
| `project_id` | string | Yes | Unique identifier of the project containing the task. |
| `organization_id` | string | Yes | The Zoho Invoice organization ID. Required when user belongs to multiple organizations. |

#### 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 Tax

**Slug:** `ZOHO_INVOICE_GET_TAX`

Tool to retrieve details of a specific tax by tax_id. Use when you need to fetch information about a tax rate configured in Zoho Invoice.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tax_id` | string | Yes | Unique identifier of the tax to retrieve. |
| `organization_id` | string | No | The Zoho Invoice organization ID. Required when user belongs to multiple organizations. |

#### 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 Tax Group

**Slug:** `ZOHO_INVOICE_GET_TAX_GROUP`

Tool to retrieve a specific tax group by ID. Use when you need to fetch details about a tax group including its name, total percentage, and individual taxes.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tax_group_id` | string | Yes | Unique identifier of the tax group to retrieve. |
| `organization_id` | string | Yes | The Zoho Invoice organization ID. Required for multi-organization accounts. |

#### 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 Time Entry

**Slug:** `ZOHO_INVOICE_GET_TIME_ENTRY`

Tool to retrieve a specific time entry from Zoho Invoice. Use when you need to fetch details of a time entry by its ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `time_entry_id` | string | Yes | Unique identifier of the time entry to retrieve. |
| `organization_id` | string | Yes | The Zoho Invoice organization ID (X-com-zoho-invoice-organizationid header) |

#### 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 |

### Inactivate Project

**Slug:** `ZOHO_INVOICE_INACTIVATE_PROJECT`

Tool to deactivate a project in Zoho Invoice. Use when you need to change a project's status from active to inactive.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `project_id` | string | Yes | Unique identifier of the project to deactivate |
| `organization_id` | string | Yes | The Zoho Invoice organization ID (X-com-zoho-invoice-organizationid header) |

#### 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 Child Expenses Created

**Slug:** `ZOHO_INVOICE_LIST_CHILD_EXPENSES_CREATED`

Tool to list child expenses created from a recurring expense. Use when you need to retrieve all expense instances generated from a recurring expense pattern.

#### 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. |
| `sort_column` | string ("next_expense_date" | "account_name" | "total" | "last_created_date" | "recurrence_name" | "customer_name" | "created_time") | No | Allowed sort columns for child expenses listing. |
| `organization_id` | string | No | The Zoho Invoice organization ID. Required when the user belongs to multiple organizations. |
| `recurring_expense_id` | string | Yes | Unique identifier of the recurring expense. |

#### 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 Client Reviews

**Slug:** `ZOHO_INVOICE_LIST_CLIENT_REVIEWS`

Tool to retrieve all client reviews for contacts. Use when you need to view feedback and reviews from clients in Zoho Invoice.

#### 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. |
| `contact_id` | integer | No | Unique ID of a particular contact to filter reviews. |
| `organization_id` | string | Yes | The Zoho Invoice organization ID. Must be passed as query parameter 'organization_id'. |

#### 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 Contact Comments

**Slug:** `ZOHO_INVOICE_LIST_CONTACT_COMMENTS`

Tool to list all comments on a contact. Use when you need to retrieve comments or notes added to a specific contact.

#### 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. |
| `contact_id` | string | Yes | Unique identifier of the contact to retrieve comments for |
| `organization_id` | string | Yes | The Zoho Invoice organization ID |

#### 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 Contact Refunds

**Slug:** `ZOHO_INVOICE_LIST_CONTACT_REFUNDS`

Tool to list refunds associated with a contact. Use when you need to retrieve all refunds for a specific contact with optional pagination.

#### 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. |
| `contact_id` | string | Yes | Unique identifier of the contact whose refunds to retrieve |
| `organization_id` | string | Yes | The Zoho Invoice organization ID. Required when user belongs to multiple organizations. |

#### 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_INVOICE_LIST_CONTACTS`

Tool to list contacts. Use after obtaining the organization ID to retrieve contacts with optional filters and pagination.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for pagination, starts at 1 |
| `email` | string | No | Search contacts by email ID of the contact person (exact match) |
| `phone` | string | No | Search contacts by phone number of the contact person (exact match) |
| `address` | string | No | Search contacts by any of the address fields (exact match) |
| `per_page` | integer | No | Number of contacts per page, max 200 |
| `filter_by` | string ("Status.All" | "Status.Active" | "Status.Inactive" | "Status.Duplicate" | "Status.Crm") | No | Filter contacts by status |
| `last_name` | string | No | Search contacts by last name (exact match) |
| `first_name` | string | No | Search contacts by first name (exact match) |
| `search_text` | string | No | Search contacts by contact name or notes |
| `sort_column` | string ("contact_name" | "first_name" | "last_name" | "email" | "outstanding_receivable_amount" | "created_time" | "last_modified_time") | No | Sort contacts by the specified column |
| `company_name` | string | No | Search contacts by company name (exact match) |
| `contact_name` | string | No | Search contacts by contact name (exact match) |
| `email_contains` | string | No | Search contacts by email ID of the contact person (substring match) |
| `phone_contains` | string | No | Search contacts by phone number of the contact person (substring match) |
| `organization_id` | string | Yes | The Zoho organization ID. Must be passed as query parameter 'organization_id'. |
| `zcrm_account_id` | string | No | CRM Account ID for the contact |
| `zcrm_contact_id` | string | No | CRM Contact ID for the contact |
| `address_contains` | string | No | Search contacts by any of the address fields (substring match) |
| `email_startswith` | string | No | Search contacts by email ID of the contact person (prefix match) |
| `phone_startswith` | string | No | Search contacts by phone number of the contact person (prefix match) |
| `address_startswith` | string | No | Search contacts by any of the address fields (prefix match) |
| `last_name_contains` | string | No | Search contacts by last name (substring match) |
| `first_name_contains` | string | No | Search contacts by first name (substring match) |
| `last_name_startswith` | string | No | Search contacts by last name (prefix match) |
| `company_name_contains` | string | No | Search contacts by company name (substring match) |
| `contact_name_contains` | string | No | Search contacts by contact name (substring match) |
| `first_name_startswith` | string | No | Search contacts by first name (prefix match) |
| `company_name_startswith` | string | No | Search contacts by company name (prefix match) |
| `contact_name_startswith` | string | No | Search contacts by contact name (prefix match) |

#### 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_INVOICE_LIST_CREDIT_NOTES`

Tool to list credit notes. Use when you need to retrieve all credit notes with optional filters and pagination.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `date` | string | No | The date on which credit note is raised (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") | No | Status of the credit note |
| `item_id` | string | No | Unique string generated for the item to which a refund is 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 |
| `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 |
| `sort_column` | string ("customer_name" | "creditnote_number" | "balance" | "total" | "date" | "created_time") | No | Sort credit notes by specified column |
| `customer_name` | string | No | Name of the customer to whom the credit note is raised |
| `organization_id` | string | Yes | The Zoho Invoice organization ID to list credit notes from |
| `item_description` | string | No | Description for the item. Variants item_description_startswith and item_description_contains |
| `reference_number` | string | No | Reference number generated for the payment. A string of your choice can also be used as the reference number |
| `creditnote_number` | string | No | Unique number generated (starts with CN) which will be displayed in the interface and credit notes |

#### 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_INVOICE_LIST_CURRENCIES`

Tool to list all currencies configured for the organization. Use when you need to retrieve available currencies after specifying the organization ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `organization_id` | string | Yes | The Zoho Invoice organization ID. Required to identify which organization the request applies to. |

#### 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 Customer Payment Refunds

**Slug:** `ZOHO_INVOICE_LIST_CUSTOMER_PAYMENT_REFUNDS`

Tool to list refunds of a customer payment. Use when you need to retrieve all refunds for a specific customer payment with optional pagination.

#### 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 | Yes | The Zoho Invoice organization ID. Required when user belongs to multiple organizations. |
| `customer_payment_id` | string | Yes | Unique identifier of the customer payment whose refunds to retrieve. |

#### 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 Employees

**Slug:** `ZOHO_INVOICE_LIST_EMPLOYEES`

Tool to list all employees in the organization. Use when you need to retrieve the list of employees with pagination support after specifying the organization ID.

#### 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 | Yes | The organization ID. Required when the user belongs to multiple organizations. |

#### 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 Estimates

**Slug:** `ZOHO_INVOICE_LIST_ESTIMATES`

Tool to list all estimates. Use when you need to retrieve estimates with optional filtering and pagination.

#### 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 | Yes | The Zoho Invoice organization ID (X-com-zoho-invoice-organizationid header) |
| `zcrm_potential_id` | integer | No | Potential ID of a Deal in CRM to filter estimates |

#### 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 Expense Categories

**Slug:** `ZOHO_INVOICE_LIST_EXPENSE_CATEGORIES`

Tool to list all expense categories with optional filtering, sorting, and pagination. Use when you need to retrieve expense categories for tracking business expenses.

#### 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. |
| `filter_by` | string ("ExpenseCategories.Active" | "ExpenseCategories.Inactive" | "ExpenseCategories.All") | No | Filter options for expense categories by status. |
| `sort_column` | string ("account_name") | No | Sort column options for expense categories. |
| `organization_id` | string | Yes | The Zoho Invoice organization ID (X-com-zoho-invoice-organizationid header) |

#### 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 Expense Comments

**Slug:** `ZOHO_INVOICE_LIST_EXPENSE_COMMENTS`

Tool to list expense history and comments. Use when you need to retrieve all comments, notes, and history entries for a specific expense.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `expense_id` | string | Yes | Unique identifier of the expense to retrieve comments for |
| `organization_id` | string | Yes | The Zoho organization ID. Required for authentication. |

#### 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 Expenses

**Slug:** `ZOHO_INVOICE_LIST_EXPENSES`

List all expenses with optional filtering, sorting, and pagination. Use this tool when you need to: - Retrieve a list of expenses - Filter expenses by status (billable, unbilled, invoiced, reimbursed) - Search expenses by customer name, account name, or description - Filter expenses by date range - Sort expenses by date, total, account name, etc.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for pagination, starting at 1 |
| `status` | string | No | Search by expense status. Allowed values: unbilled, invoiced, reimbursed, non-billable, billable |
| `date_end` | string | No | Filter expenses until this date (format: yyyy-mm-dd) |
| `per_page` | integer | No | Number of records per page (max 200). Default is 200. |
| `filter_by` | string | No | Filter expenses by status. Allowed values: Status.All, Status.Billable, Status.Nonbillable, Status.Reimbursed, Status.Invoiced, Status.Unbilled |
| `date_start` | string | No | Filter expenses from this date (format: yyyy-mm-dd) |
| `customer_id` | string | No | Filter expenses by customer ID |
| `search_text` | string | No | Search expenses by account name, description, customer name, or vendor name (max 100 chars) |
| `sort_column` | string | No | Column to sort by. Allowed values: date, account_name, total, bcy_total, reference_number, customer_name, created_time |
| `account_name` | string | No | Search expenses by expense account name (max 100 chars) |
| `customer_name` | string | No | Search expenses by customer name (max 100 chars) |

#### 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 Comments

**Slug:** `ZOHO_INVOICE_LIST_INVOICE_COMMENTS`

Tool to list all comments and history for an invoice. Use when you need to retrieve comment history and notes associated with a specific invoice.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `invoice_id` | string | Yes | Unique identifier of the invoice to retrieve comments for |
| `organization_id` | string | Yes | Unique identifier 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 |

### List Invoice Payments

**Slug:** `ZOHO_INVOICE_LIST_INVOICE_PAYMENTS`

Tool to list payments for a specific invoice. Use when you need to retrieve all payments applied to a particular invoice.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `invoice_id` | string | Yes | Unique identifier of the invoice to list payments for |
| `organization_id` | string | Yes | Organization ID - required when user belongs to multiple organizations. Obtained from error response or organization settings. |

#### 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_INVOICE_LIST_INVOICES`

Tool to list invoices. Use after obtaining the organization ID to retrieve invoices with optional filters and pagination.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `date` | string | No | Invoice date (yyyy-mm-dd) |
| `page` | integer | No | Page number for pagination, starts at 1 |
| `email` | string | No | Search by email ID of the contact person |
| `total` | number | No | Total amount of the invoice |
| `status` | string ("sent" | "draft" | "overdue" | "paid" | "void" | "unpaid" | "partially_paid" | "viewed") | No | Status of the invoice |
| `balance` | number | No | Unpaid balance of the invoice |
| `item_id` | string | No | Unique identifier for the item |
| `date_end` | string | No | End date for invoice date range |
| `due_date` | string | No | Due date of the invoice (yyyy-mm-dd) |
| `per_page` | integer | No | Number of items per page for pagination |
| `filter_by` | string ("Status.All" | "Status.Sent" | "Status.Draft" | "Status.OverDue" | "Status.Paid" | "Status.Void" | "Status.Unpaid" | "Status.PartiallyPaid" | "Status.Viewed" | "Date.PaymentExpectedDate") | No | Filter invoices by status or payment expected date |
| `item_name` | string | No | Search by item name (exact match) |
| `date_after` | string | No | Fetch invoices after this date |
| `date_start` | string | No | Start date for invoice date range |
| `customer_id` | string | No | ID of the customer |
| `date_before` | string | No | Fetch invoices before this date |
| `search_text` | string | No | Search by invoice number, purchase order, or customer name |
| `sort_column` | string ("customer_name" | "invoice_number" | "date" | "due_date" | "total" | "balance" | "created_time") | No | Sort invoices by specified column |
| `custom_field` | string | No | Search by custom field (exact match) |
| `due_date_end` | string | No | End date for due date range |
| `customer_name` | string | No | Search by customer name (exact match) |
| `due_date_after` | string | No | Fetch invoices due after this date |
| `due_date_start` | string | No | Start date for due date range |
| `invoice_number` | string | No | Unique number assigned to the invoice (exact match) |
| `due_date_before` | string | No | Fetch invoices due before this date |
| `organization_id` | string | Yes | The Zoho Invoice organization ID. |
| `item_description` | string | No | Search by item description (exact match) |
| `reference_number` | string | No | Reference number of the invoice |
| `zcrm_potential_id` | string | No | CRM Deal potential ID |
| `item_name_contains` | string | No | Search by item name (substring match) |
| `item_name_startswith` | string | No | Search by item name (prefix match) |
| `recurring_invoice_id` | string | No | ID of the recurring invoice |
| `custom_field_contains` | string | No | Search by custom field (substring match) |
| `custom_field_startswith` | string | No | Search by custom field (prefix match) |
| `item_description_contains` | string | No | Search by item description (substring match) |
| `item_description_startswith` | string | No | Search by item description (prefix match) |

#### 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 Credited

**Slug:** `ZOHO_INVOICE_LIST_INVOICES_CREDITED`

Tool to list invoices to which a specific credit note has been applied. Use when you need to see which invoices have received credits from a particular credit note.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `creditnote_id` | string | Yes | Unique identifier of the credit note |
| `organization_id` | string | Yes | The Zoho Invoice organization ID (passed as X-com-zoho-invoice-organizationid header) |

#### 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_INVOICE_LIST_ITEMS`

Tool to list all items. Use when you need to retrieve your item catalog with optional pagination and filtering after specifying the organization ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for pagination, starting from 1. |
| `per_page` | integer | No | Number of items per page (max 200). Default is 200 if not specified. |
| `filter_by` | string | No | Filter items by status. Allowed values: 'Status.All', 'Status.Active', 'Status.Inactive'. |
| `search_text` | string | No | Free-text search to filter items by name, description, or SKU. |
| `organization_id` | string | Yes | The Zoho Invoice organization ID to list items from. |

#### 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_INVOICE_LIST_ORGANIZATIONS`

Tool to list all organizations. Use when you need to retrieve all organizations you are part of to obtain organization IDs for other API calls.

#### 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 Payments

**Slug:** `ZOHO_INVOICE_LIST_PAYMENTS`

Tool to list payments. Use when you need to retrieve all payments with optional filters like customer, invoice, date range, and pagination.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `mode` | string | No | Filter by payment mode (e.g., 'Cash', 'Credit Card') |
| `page` | integer | No | Page number for pagination, starts at 1 |
| `date_end` | string | No | Filter payments made on or before this date (YYYY-MM-DD) |
| `per_page` | integer | No | Number of payments per page, maximum 200 |
| `filter_by` | string ("PaymentMode.All" | "PaymentMode.Check" | "PaymentMode.Cash" | "PaymentMode.BankTransfer" | "PaymentMode.Paypal" | "PaymentMode.CreditCard" | "PaymentMode.GoogleCheckout" | "PaymentMode.Credit" | "PaymentMode.Authorizenet" | "PaymentMode.BankRemittance" | "PaymentMode.Payflowpro" | "PaymentMode.Stripe" | "PaymentMode.TwoCheckout" | "PaymentMode.Braintree" | "PaymentMode.Others") | No | Filter payments by payment mode |
| `date_start` | string | No | Filter payments made on or after this date (YYYY-MM-DD) |
| `invoice_id` | string | No | Filter payments for a specific invoice by ID |
| `sort_order` | string ("A" | "D") | No | Sort order: 'A' for ascending, 'D' for descending |
| `customer_id` | string | No | Filter payments for a specific customer by ID |
| `sort_column` | string ("payment_number" | "amount" | "date" | "mode" | "reference_number") | No | Column to sort by |
| `payment_number` | string | No | Filter by payment number |
| `reference_number` | string | No | Filter by reference number |

#### 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 Price Lists

**Slug:** `ZOHO_INVOICE_LIST_PRICE_LISTS`

Tool to list all price lists. Use when you need to retrieve available price lists with optional pagination.

#### 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 | Yes | ID of the organization. Required for all Zoho Invoice API calls. |

#### 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 Project Comments

**Slug:** `ZOHO_INVOICE_LIST_PROJECT_COMMENTS`

Tool to list all comments for a project. Use when you need to retrieve comments or notes associated with a specific project.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `project_id` | string | Yes | Unique identifier of the project |
| `organization_id` | string | Yes | The Zoho Invoice organization ID |

#### 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 Project Invoices

**Slug:** `ZOHO_INVOICE_LIST_PROJECT_INVOICES`

Tool to list all invoices for a specific project. Use when you need to retrieve invoices associated with a project, with optional sorting and pagination.

#### 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 |
| `project_id` | string | Yes | Unique identifier of the project to retrieve invoices for |
| `sort_column` | string ("invoice_number" | "date" | "total" | "balance" | "created_time") | No | Sort column options for listing project invoices. |
| `organization_id` | string | Yes | The Zoho Invoice organization ID. Required when user belongs to multiple organizations. |

#### 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 Projects

**Slug:** `ZOHO_INVOICE_LIST_PROJECTS`

Tool to list all projects. Use when you need to retrieve projects with optional filters by status or customer, and pagination support.

#### 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. |
| `filter_by` | string ("Status.All" | "Status.Active" | "Status.Inactive") | No | Filter options for project status. |
| `customer_id` | string | No | Unique ID of the customer to filter projects |
| `sort_column` | string ("project_name" | "customer_name" | "rate" | "created_time") | No | Sort column options for projects. |
| `organization_id` | string | Yes | The Zoho organization ID. Must be passed as query parameter 'organization_id'. |

#### 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 Project Users

**Slug:** `ZOHO_INVOICE_LIST_PROJECT_USERS`

Tool to list all users assigned to a specific project. Use when you need to retrieve all users working on a project.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `project_id` | string | Yes | Unique identifier of the project. |
| `organization_id` | string | Yes | The Zoho Invoice organization ID. Required for authentication. |

#### 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 Recurring Invoices

**Slug:** `ZOHO_INVOICE_LIST_RECURRING_INVOICES`

Tool to list recurring invoices. Use when you need to retrieve all recurring invoices with optional filters for status, search text, and pagination.

#### 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. |
| `filter_by` | string ("Status.All" | "Status.Active" | "Status.Stopped" | "Status.Expired") | No | Filter recurring invoices by status or payment expected date. Use Status.All for all invoices, Status.Active for active, Status.Stopped for stopped, or Status.Expired for expired recurring invoices. |
| `search_text` | string | No | Search invoices by invoice number, purchase order, or customer name |
| `sort_column` | string | No | Sort based on column value (e.g., created_time, customer_name) |
| `organization_id` | string | No | The unique ID of the organization. Required when user belongs to multiple organizations. |

#### 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 Retainer Invoices

**Slug:** `ZOHO_INVOICE_LIST_RETAINER_INVOICES`

Tool to list retainer invoices. Use when you need to retrieve all retainer invoices with optional filters and pagination.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for pagination, starts at 1 |
| `print` | boolean | No | Print the exported pdf |
| `per_page` | integer | No | Number of retainer invoices per page. Default value is 200. |
| `filter_by` | string ("Status.All" | "Status.Sent" | "Status.Draft" | "Status.OverDue" | "Status.Paid" | "Status.Void" | "Status.Unpaid" | "Status.PartiallyPaid" | "Status.Viewed" | "Date.PaymentExpectedDate") | No | Filter retainer invoices by status or payment expected date |
| `sort_order` | string ("A" | "D") | No | Sort order: 'A' for ascending, 'D' for descending |
| `sort_column` | string ("customer_name" | "retainerinvoice_number" | "date" | "due_date" | "total" | "balance" | "created_time") | No | Sort retainer invoices by specified column |
| `organization_id` | string | No | The unique ID of the organization. Required when user belongs to multiple organizations. |

#### 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 Retainer Invoice Templates

**Slug:** `ZOHO_INVOICE_LIST_RETAINER_INVOICE_TEMPLATES`

Tool to list retainer invoice templates. Use when you need to retrieve available retainer invoice templates for an organization.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `organization_id` | string | Yes | Required when user belongs to multiple organizations. Specifies which organization's retainer invoice templates to retrieve. |

#### 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 Users

**Slug:** `ZOHO_INVOICE_LIST_USERS`

Tool to list users in a Zoho Invoice organization. Use after obtaining the organization ID to retrieve all users with optional filters and pagination.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for pagination, starts at 1. Default is 1. |
| `per_page` | integer | No | Number of users per page. Default is 200, maximum is 200. |
| `filter_by` | string | No | Criteria used to filter users (e.g., 'Status.Active', 'Status.Inactive') |
| `sort_column` | string ("name" | "email" | "user_role" | "status") | No | Sort users by the specified column. Allowed values: name, email, user_role, status |
| `organization_id` | string | Yes | The Zoho organization ID. Required for authentication via X-com-zoho-invoice-organizationid header. |

#### 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 |

### Mark Contact as Active

**Slug:** `ZOHO_INVOICE_MARK_CONTACT_ACTIVE`

Tool to mark an inactive contact as active. Use when you need to reactivate a previously deactivated contact.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `contact_id` | string | Yes | Unique identifier of the contact to mark as active |
| `organization_id` | string | Yes | The Zoho Invoice organization ID (X-com-zoho-invoice-organizationid header) |

#### 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 |

### Mark Contact as Inactive

**Slug:** `ZOHO_INVOICE_MARK_CONTACT_INACTIVE`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `contact_id` | string | Yes | Unique identifier of the contact to mark as inactive. |
| `organization_id` | string | Yes | The Zoho organization ID. Must be passed as query parameter 'organization_id'. |

#### 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 |

### Mark Contact Person as Primary

**Slug:** `ZOHO_INVOICE_MARK_CONTACT_PERSON_AS_PRIMARY`

Tool to mark a contact person as primary in Zoho Invoice. Use when you need to designate a specific contact person as the primary contact.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `organization_id` | string | Yes | The Zoho organization ID. Must be passed as header 'X-com-zoho-invoice-organizationid'. |
| `contact_person_id` | string | Yes | Unique identifier of the contact person to mark as primary. |

#### 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 |

### Mark Estimate as Declined

**Slug:** `ZOHO_INVOICE_MARK_ESTIMATE_AS_DECLINED`

Tool to mark an estimate as declined. Use when you need to change an estimate's status to declined.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `estimate_id` | string | Yes | Unique identifier of the estimate to mark as declined. |
| `organization_id` | string | Yes | The Zoho Invoice organization ID. Required when user belongs to multiple organizations. |

#### 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 |

### Mark Expense Category as Active

**Slug:** `ZOHO_INVOICE_MARK_EXPENSE_CATEGORY_ACTIVE`

Tool to mark an inactive expense category as active. Use when you need to reactivate a previously deactivated expense category.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `category_id` | string | Yes | Unique identifier of the expense category to mark as active |
| `organization_id` | string | Yes | The Zoho Invoice organization ID (X-com-zoho-invoice-organizationid header) |

#### 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 |

### Mark Invoice as Sent

**Slug:** `ZOHO_INVOICE_MARK_INVOICE_AS_SENT`

Tool to mark an invoice as sent. Use when you need to update an invoice's status to sent without actually emailing it.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `invoice_id` | string | Yes | Unique identifier of the invoice to mark as sent |
| `organization_id` | string | Yes | The Zoho Invoice organization ID (X-com-zoho-invoice-organizationid header) |

#### 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 |

### Mark Invoice as Void

**Slug:** `ZOHO_INVOICE_MARK_INVOICE_AS_VOID`

Tool to mark an invoice as void. Use when you need to void an existing invoice without deleting it.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `invoice_id` | string | Yes | Unique identifier of the invoice to mark as void. |
| `organization_id` | string | Yes | The Zoho Invoice organization ID. Required when user belongs to multiple organizations. Passed as X-com-zoho-invoice-organizationid header. |

#### 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 |

### Mark Item as Inactive

**Slug:** `ZOHO_INVOICE_MARK_ITEM_AS_INACTIVE`

Tool to mark an active item as inactive. Use when you need to deactivate an item without deleting it.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `item_id` | string | Yes | Unique ID of the item to mark as inactive |
| `organization_id` | string | Yes | The Zoho Invoice organization ID (X-com-zoho-invoice-organizationid header) |

#### 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 |

### Mark Retainer Invoice as Sent

**Slug:** `ZOHO_INVOICE_MARK_RETAINER_INVOICE_AS_SENT`

Tool to mark a retainer invoice as sent. Use when you need to update a retainer invoice's status to sent without actually emailing it.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `organization_id` | string | Yes | The Zoho Invoice organization ID (X-com-zoho-invoice-organizationid header) |
| `retainerinvoice_id` | string | Yes | Unique identifier of the retainer invoice to mark as sent |

#### 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 Estimates

**Slug:** `ZOHO_INVOICE_PRINT_ESTIMATES`

Tool to bulk print multiple estimates as PDF. Use when you need to generate printable versions of multiple estimates at once. Maximum of 10 estimates can be printed at once.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `estimate_ids` | string | Yes | Comma-separated estimate IDs to be printed. Maximum of 10 estimates can be printed at once. |
| `organization_id` | string | Yes | The Zoho Invoice organization ID (X-com-zoho-invoice-organizationid header) |

#### 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_INVOICE_PRINT_INVOICES`

Tool to bulk print invoices as PDF. Use when you need to export and print multiple invoices. Maximum of 25 invoices can be printed at once.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `invoice_ids` | string | Yes | Comma-separated list of invoice IDs to print. Maximum of 25 invoices can be printed at once. |
| `organization_id` | string | Yes | The Zoho Invoice organization ID. Required to identify 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 |

### Refund Customer Payment

**Slug:** `ZOHO_INVOICE_REFUND_CUSTOMER_PAYMENT`

Tool to refund an excess customer payment. Use when you need to process a refund for a customer payment that has excess funds.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `date` | string | Yes | Date on which refund is made. Date Format [yyyy-mm-dd] |
| `amount` | number | Yes | Amount to be refunded. Must be greater than 0. |
| `description` | string | No | Description or notes about the refund. |
| `refund_mode` | string | No | The method of refund (e.g., cash, check, bank_transfer, credit_card). |
| `payment_form` | string | No | Mode of vendor payment. This field is only applicable for Mexico. |
| `exchange_rate` | number | No | Exchange rate for currency conversion. Default is 1. |
| `organization_id` | string | Yes | Organization ID to associate the request with a specific organization. Sent as X-com-zoho-invoice-organizationid header. |
| `reference_number` | string | No | Reference number for the refund. |
| `customer_payment_id` | string | Yes | Unique identifier of the customer payment to refund. |

#### 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 |

### Resume Recurring Invoice

**Slug:** `ZOHO_INVOICE_RESUME_RECURRING_INVOICE`

Tool to resume a recurring invoice in Zoho Invoice. Use when you need to reactivate a stopped recurring invoice to restart automatic invoice generation.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `organization_id` | string | No | The Zoho Invoice organization ID. Required when user belongs to multiple organizations. |
| `recurring_invoice_id` | string | Yes | Unique identifier of the recurring invoice to resume. |

#### 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 |

### Send Bulk Invoice Reminder

**Slug:** `ZOHO_INVOICE_SEND_BULK_INVOICE_REMINDER`

Tool to send payment reminders for multiple invoices in bulk. Use when you need to remind customers about pending payments for multiple invoices at once.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `invoice_ids` | string | Yes | Comma-separated list of invoice IDs to send payment reminders for. Example: '3476910000000032526,3476910000000038118' |
| `organization_id` | string | Yes | The Zoho organization ID. Required for all Zoho Invoice API calls. |

#### 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 |

### Send Contact Email

**Slug:** `ZOHO_INVOICE_SEND_CONTACT_EMAIL`

Tool to send an email to a contact in Zoho Invoice. Use when you need to email customer statements or other communications to contacts.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `body` | string | Yes | Body content of the email |
| `subject` | string | Yes | Subject line of the email |
| `contact_id` | string | Yes | Unique identifier of the contact to send email to |
| `to_mail_ids` | array | Yes | Array of email addresses to send the email to |
| `organization_id` | string | Yes | The Zoho organization ID. Required for authentication (X-com-zoho-invoice-organizationid header) |
| `send_customer_statement` | boolean | No | Send customer statement PDF with 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 |

### Start Timer

**Slug:** `ZOHO_INVOICE_START_TIMER`

Tool to start a timer on an existing time entry in Zoho Invoice. Use when you need to begin tracking time on a previously created time entry.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `time_entry_id` | string | Yes | Unique identifier of the time entry to start the timer for. |
| `organization_id` | string | Yes | The Zoho Invoice organization ID (X-com-zoho-invoice-organizationid header) |

#### 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 |

### Stop Recurring Invoice

**Slug:** `ZOHO_INVOICE_STOP_RECURRING_INVOICE`

Tool to stop a recurring invoice in Zoho Invoice. Use when you need to prevent future invoices from being automatically generated while keeping the profile and history intact.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `organization_id` | string | No | The Zoho Invoice organization ID. Required when user belongs to multiple organizations. |
| `recurring_invoice_id` | string | Yes | Unique identifier of the recurring invoice to stop. |

#### 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 |

### Update Additional Address

**Slug:** `ZOHO_INVOICE_UPDATE_ADDITIONAL_ADDRESS`

Tool to update an additional address for a contact. Use when you need to modify an existing secondary shipping or billing address.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `fax` | string | No | Fax number |
| `zip` | string | No | Postal/zip code |
| `city` | string | No | City name |
| `phone` | string | No | Phone number |
| `state` | string | No | State name |
| `address` | string | No | Primary address line, max 500 characters |
| `country` | string | No | Country name |
| `street2` | string | No | Secondary address line |
| `attention` | string | No | Contact person's name for the address |
| `address_id` | string | Yes | Unique identifier of the address to update |
| `contact_id` | string | Yes | Unique identifier of the contact to update the address for |
| `state_code` | string | No | State abbreviation |
| `organization_id` | string | Yes | The Zoho Invoice organization ID (X-com-zoho-invoice-organizationid header) |

#### 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 |

### Update Contact

**Slug:** `ZOHO_INVOICE_UPDATE_CONTACT`

Tool to update an existing contact in Zoho Invoice. Use when you need to modify customer or vendor information. To delete a contact person, remove it from the contact_persons list.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `notes` | string | No | Notes about the contact |
| `gst_no` | string | No | GST number (India region) |
| `tax_id` | string | No | Tax ID |
| `twitter` | string | No | Twitter profile URL |
| `website` | string | No | Website URL |
| `facebook` | string | No | Facebook profile URL |
| `contact_id` | string | Yes | The unique identifier for the contact being modified |
| `legal_name` | string | No | Legal name of the business (Mexico region) |
| `tax_reg_no` | string | No | Tax registration number (Mexico region) |
| `tax_regime` | string | No | Tax regime (Mexico region) |
| `vat_reg_no` | string | No | VAT registration number (UK region) |
| `currency_id` | string | No | Currency identifier |
| `company_name` | string | No | Company name |
| `contact_name` | string | No | Name of the contact. This can be the name of an organisation or the name of an individual |
| `country_code` | string | No | Country code (UK region) |
| `custom_fields` | array | No | Array of custom field objects |
| `gst_treatment` | string | No | GST treatment type (India region) |
| `language_code` | string | No | Language code for the contact. Allowed values: de, en, es, fr, it, ja, nl, pt, sv, zh |
| `payment_terms` | integer | No | Payment terms in days |
| `tax_treatment` | string | No | Tax treatment type |
| `vat_treatment` | string | No | VAT treatment type (UK region) |
| `billing_address` | object | No | Billing address details for the contact. |
| `contact_persons` | array | No | Array of contact person objects. To delete a contact person, remove it from this list |
| `organization_id` | string | Yes | The Zoho organization ID. Required for authentication. |
| `place_of_contact` | string | No | Place of contact (India region) |
| `shipping_address` | object | No | Shipping address details for the contact. |
| `tax_authority_id` | string | No | Tax authority ID |
| `tax_exemption_id` | string | No | Tax exemption ID |

#### 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 |

### Update Contact Person

**Slug:** `ZOHO_INVOICE_UPDATE_CONTACT_PERSON`

Tool to update a contact person in Zoho Invoice. Use when you need to modify details of an existing contact person such as name, email, phone, or other attributes.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | No | Email address of the contact person |
| `phone` | string | No | Phone number of the contact person |
| `skype` | string | No | Skype ID of the contact person |
| `mobile` | string | No | Mobile number of the contact person |
| `last_name` | string | No | Last name of the contact person |
| `contact_id` | string | Yes | Identifier of the parent contact to which this contact person belongs |
| `department` | string | No | Department in which the contact person works |
| `first_name` | string | Yes | First name of the contact person. Required field. |
| `salutation` | string | No | Salutation for the contact person (e.g., Mr., Ms., Dr.) |
| `designation` | string | No | Job title or designation of the contact person |
| `enable_portal` | boolean | No | Enable portal access for the contact person. Set to true to allow portal login. |
| `organization_id` | string | Yes | The Zoho organization ID. Must be passed as header 'X-com-zoho-invoice-organizationid'. |
| `contact_person_id` | string | Yes | Unique identifier of the contact person to update. |

#### 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 |

### Update Credit Note

**Slug:** `ZOHO_INVOICE_UPDATE_CREDIT_NOTE`

Tool to update an existing credit note in Zoho Invoice. Use when you need to modify credit note details such as line items, reference numbers, or notes.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `date` | string | Yes | Credit note date in yyyy-mm-dd format |
| `notes` | string | No | Credit note memo or notes |
| `terms` | string | No | Terms and conditions for the credit note |
| `line_items` | array | Yes | List of items included in the credit note. At least one item is required. |
| `customer_id` | string | Yes | Customer ID of the customer for whom the credit note is raised |
| `creditnote_id` | string | Yes | Unique identifier of the credit note to update |
| `organization_id` | string | Yes | The Zoho Invoice organization ID (sent as X-com-zoho-invoice-organizationid header) |
| `reference_number` | string | No | Custom reference number for the credit note |
| `creditnote_number` | string | Yes | Unique credit note number (typically starts with CN) |
| `ignore_auto_number_generation` | boolean | No | Set to true to use custom credit note numbers instead of auto-generated ones |

#### 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 |

### Update Credit Note Template

**Slug:** `ZOHO_INVOICE_UPDATE_CREDIT_NOTE_TEMPLATE`

Tool to update the template associated with a credit note. Use when you need to change the PDF template applied to an existing credit note.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `template_id` | string | Yes | Unique identifier of the credit note template to apply |
| `creditnote_id` | string | Yes | Unique identifier of the credit note whose template is to be updated |
| `organization_id` | string | Yes | The Zoho Invoice organization ID. Required when user belongs to multiple organizations. |

#### 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 |

### Update Customer Payment Refund

**Slug:** `ZOHO_INVOICE_UPDATE_CUSTOMER_PAYMENT_REFUND`

Tool to update an existing customer payment refund. Use when you need to modify refund details such as amount, date, refund mode, reference number, or description.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `date` | string | No | Date on which payment is made. Format [yyyy-mm-dd] |
| `amount` | number | No | Amount paid in the respective payment |
| `refund_id` | string | Yes | Unique identifier of the refund to update. |
| `description` | string | No | Details about the payment transaction |
| `refund_mode` | string | No | The method of refund (e.g., check, cash, bank_transfer). Maximum length [50] |
| `payment_form` | string | No | Mode of payment (Mexico only) |
| `exchange_rate` | number | No | Exchange rate for currency conversion; defaults to 1 |
| `organization_id` | string | Yes | Organization ID header required for multi-org accounts (X-com-zoho-invoice-organizationid) |
| `reference_number` | string | No | Reference number generated for the payment. Maximum length [100] |
| `customer_payment_id` | string | Yes | Unique identifier of the customer payment. |

#### 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 |

### Update Estimate Shipping Address

**Slug:** `ZOHO_INVOICE_UPDATE_ESTIMATE_SHIPPING_ADDRESS`

Tool to update the shipping address for an estimate. Use when you need to modify the delivery address for an existing estimate.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `fax` | string | No | Fax number (optional) |
| `zip` | string | Yes | Zip/Postal code for shipping address |
| `city` | string | Yes | City for shipping address |
| `phone` | string | No | Phone number (optional) |
| `state` | string | Yes | State/Province for shipping address |
| `address` | string | Yes | Street address for shipping |
| `country` | string | Yes | Country for shipping address |
| `street2` | string | No | Second address line (optional) |
| `attention` | string | No | Attention/contact name (optional) |
| `estimate_id` | string | Yes | Unique identifier of the estimate to update |
| `organization_id` | string | Yes | The Zoho Invoice organization ID (X-com-zoho-invoice-organizationid header) |

#### 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 |

### Write Off Invoice

**Slug:** `ZOHO_INVOICE_WRITE_OFF_INVOICE`

Tool to write off an invoice. Use when you need to mark an invoice amount as uncollectable or bad debt.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `invoice_id` | string | Yes | Unique identifier of the invoice to write off |
| `organization_id` | string | Yes | The Zoho organization ID. Must be passed as query parameter 'organization_id'. |

#### 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 |