# Zoho Invoice

Your Toolhouse AI Worker can connect to Zoho Invoice using 137 specialized tools.

## Auth Connection

This service requires an auth connection to use its tools. You can set this up in your Toolhouse dashboard under [Auth Connections](https://toolhouse.app/auth-connections?authkit_slugs=zoho_invoice).

## Tools (137)

### `Zoho Invoice Add Creditnote To Invoices`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter         | Type   | Required | Example                 | Description                                                                                                                                           |
| ----------------- | ------ | :------: | ----------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| `invoices`        | array  |     ✅    | —                       | 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 |     ✅    | `"3476910000000071262"` | Unique identifier of the credit note to apply to invoices                                                                                             |
| `organization_id` | string |     ✅    | `"60064402512"`         | The Zoho Invoice organization ID (passed as X-com-zoho-invoice-organizationid header)                                                                 |

***

### `Zoho Invoice Add Invoice Comment`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter                | Type    | Required | Example                                             | Description                                                                         |
| ------------------------ | ------- | :------: | --------------------------------------------------- | ----------------------------------------------------------------------------------- |
| `invoice_id`             | string  |     ✅    | `"982000000567114"`                                 | Unique identifier of the invoice to add a comment to                                |
| `description`            | string  |     ✅    | `"Test comment added via API for testing purposes"` | The comment text to be added to the invoice                                         |
| `organization_id`        | string  |     ✅    | `"60064402512"`                                     | The Zoho Invoice organization ID (sent as X-com-zoho-invoice-organizationid header) |
| `show_comment_to_client` | boolean |          | —                                                   | Boolean to determine whether the comment should be shown to the client              |

***

### `Zoho Invoice Apply Credits To Invoice`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

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

***

### `Zoho Invoice Cancel Write Off Invoice`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter         | Type   | Required | Example                 | Description                                                                     |
| ----------------- | ------ | :------: | ----------------------- | ------------------------------------------------------------------------------- |
| `invoice_id`      | string |     ✅    | `"3476910000000032538"` | Unique identifier of the invoice to cancel write-off                            |
| `organization_id` | string |     ✅    | `"60064402512"`         | The Zoho organization ID. Must be passed as query parameter 'organization\_id'. |

***

### `Zoho Invoice Clone Project`

Integration name: **ZOHO\_INVOICE\_CLONE\_PROJECT**

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

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter         | Type   | Required | Example                                                                       | Description                                                                 |
| ----------------- | ------ | :------: | ----------------------------------------------------------------------------- | --------------------------------------------------------------------------- |
| `project_id`      | string |     ✅    | `"3525328000000033008"`                                                       | Unique identifier of the project to clone                                   |
| `description`     | string |          | `"This is a cloned project created to test the clone endpoint functionality"` | Description for the cloned project                                          |
| `project_name`    | string |     ✅    | `"Cloned Project - Test Clone Endpoint"`                                      | Name of the cloned project                                                  |
| `organization_id` | string |     ✅    | `"60065671998"`                                                               | The Zoho Invoice organization ID (X-com-zoho-invoice-organizationid header) |

***

### `Zoho Invoice Create Additional Address`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter         | Type   | Required | Example                  | Description                                                                 |
| ----------------- | ------ | :------: | ------------------------ | --------------------------------------------------------------------------- |
| `fax`             | string |          | —                        | Fax number for this address                                                 |
| `zip`             | string |          | `"94105"`                | Postal/ZIP code                                                             |
| `city`            | string |          | `"San Francisco"`        | City name                                                                   |
| `phone`           | string |          | `"+1-555-0123"`          | Phone number for this address                                               |
| `state`           | string |          | `"CA"`                   | State or province name                                                      |
| `address`         | string |          | `"456 Secondary Street"` | Street address line 1                                                       |
| `country`         | string |          | `"USA"`                  | Country name                                                                |
| `street2`         | string |          | `"Suite 200"`            | Street address line 2 (suite, building, floor, etc.)                        |
| `attention`       | string |          | `"John Doe"`             | Contact person name for the address                                         |
| `contact_id`      | string |     ✅    | `"3476910000000098136"`  | Unique identifier of the contact to add the address to                      |
| `state_code`      | string |          | —                        | State code for the address                                                  |
| `organization_id` | string |     ✅    | `"60064402512"`          | The Zoho Invoice organization ID (X-com-zoho-invoice-organizationid header) |

***

### `Zoho Invoice Create Contact`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

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

***

### `Zoho Invoice Create Contact Person`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

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

***

### `Zoho Invoice Create Credit Note`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

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

***

### `Zoho Invoice Create Credit Note Comment`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter         | Type   | Required | Example                        | Description                                                                 |
| ----------------- | ------ | :------: | ------------------------------ | --------------------------------------------------------------------------- |
| `description`     | string |     ✅    | `"Test comment added via API"` | The comment text to be added to the credit note                             |
| `creditnote_id`   | string |     ✅    | `"3476910000000082344"`        | Unique identifier of the credit note to add a comment to                    |
| `organization_id` | string |     ✅    | `"60064402512"`                | The Zoho Invoice organization ID (X-com-zoho-invoice-organizationid header) |

***

### `Zoho Invoice Create Currency`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

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

***

### `Zoho Invoice Create Customer Payment`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter          | Type   | Required | Example                                                       | Description                                                                                     |
| ------------------ | ------ | :------: | ------------------------------------------------------------- | ----------------------------------------------------------------------------------------------- |
| `date`             | string |     ✅    | `"2026-02-16"`                                                | Date of payment in yyyy-mm-dd format                                                            |
| `amount`           | number |     ✅    | `100`                                                         | Total amount paid in the respective payment                                                     |
| `invoices`         | array  |     ✅    | `[{"invoice_id":"3476910000000032538","amount_applied":100}]` | List of invoices to apply the payment to. Each invoice requires invoice\_id and amount\_applied |
| `customer_id`      | string |     ✅    | `"3476910000000032451"`                                       | Customer ID of the customer involved in the payment                                             |
| `description`      | string |          | `"Test payment for invoice INV-000009"`                       | Description of the payment                                                                      |
| `bank_charges`     | number |          | `5`                                                           | Bank charges incurred for the payment                                                           |
| `payment_mode`     | string |     ✅    | `"cash"`                                                      | Mode through which payment is made                                                              |
| `organization_id`  | string |     ✅    | `"60064402512"`                                               | The Zoho Invoice organization ID (sent as X-com-zoho-invoice-organizationid header)             |
| `reference_number` | string |          | `"PAY-TEST-003"`                                              | Reference number for the payment (max 100 characters)                                           |

***

### `Zoho Invoice Create Employee`

Integration name: **ZOHO\_INVOICE\_CREATE\_EMPLOYEE**

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

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter         | Type   | Required | Example                  | Description                                                                                  |
| ----------------- | ------ | :------: | ------------------------ | -------------------------------------------------------------------------------------------- |
| `name`            | string |     ✅    | `"John Doe"`             | Name of the employee                                                                         |
| `email`           | string |     ✅    | `"john.doe@example.com"` | Email address of the employee                                                                |
| `organization_id` | string |     ✅    | `"60064402512"`          | ID of the Zoho organization. This will be passed as X-com-zoho-invoice-organizationid header |

***

### `Zoho Invoice Create Estimate`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

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

***

### `Zoho Invoice Create Estimate Comment`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter         | Type   | Required | Example                               | Description                                                                    |
| ----------------- | ------ | :------: | ------------------------------------- | ------------------------------------------------------------------------------ |
| `description`     | string |     ✅    | `"This is a comment on the estimate"` | The comment text to add to the estimate                                        |
| `estimate_id`     | string |     ✅    | `"3476910000000099182"`               | Unique identifier of the estimate to add the comment to                        |
| `organization_id` | string |     ✅    | `"60064402512"`                       | The Zoho organization ID. Must be passed as query parameter 'organization\_id' |

***

### `Zoho Invoice Create Exchange Rate`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

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

***

### `Zoho Invoice Create Expense Category`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter         | Type   | Required | Example                                 | Description                                                                 |
| ----------------- | ------ | :------: | --------------------------------------- | --------------------------------------------------------------------------- |
| `description`     | string |          | `"Expenses related to business travel"` | Describe the expense category                                               |
| `account_name`    | string |     ✅    | `"Travel Expenses"`                     | Account name of the expense category                                        |
| `organization_id` | string |     ✅    | `"10234695"`                            | The Zoho Invoice organization ID (X-com-zoho-invoice-organizationid header) |

***

### `Zoho Invoice Create Invoice`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

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

***

### `Zoho Invoice Create Item`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter              | Type    | Required | Example                                                      | Description                                                                                    |
| ---------------------- | ------- | :------: | ------------------------------------------------------------ | ---------------------------------------------------------------------------------------------- |
| `sku`                  | string  |          | `"CONS-001"`                                                 | Stock Keeping Unit (SKU) code. Must be unique across products.                                 |
| `name`                 | string  |     ✅    | `"Consulting Service"`                                       | Name of the item. Maximum length: 100 characters.                                              |
| `rate`                 | number  |     ✅    | `149.99`                                                     | Per unit price of the item                                                                     |
| `tax_id`               | string  |          | `"982000000037049"`                                          | ID of the tax to be associated with the item                                                   |
| `hsn_or_sac`           | string  |          | `"998314"`                                                   | HSN (Harmonized System of Nomenclature) or SAC (Services Accounting Code). India only.         |
| `is_taxable`           | boolean |          | `true`                                                       | Whether the item is taxable. Applicable for US, Canada, and India only.                        |
| `description`          | string  |          | `"Professional consulting services"`                         | Description of the item. Maximum length: 2000 characters.                                      |
| `product_type`         | string  |          | `"service"`                                                  | Type of item: 'goods' or 'service'                                                             |
| `unitkey_code`         | string  |          | `"E48"`                                                      | Unit Key Code from CFDI Catalogs. Mexico only.                                                 |
| `custom_fields`        | array   |          | `[{"value":"Normal","customfield_id":"46000000012845"}]`     | List of custom fields with customfield\_id and value                                           |
| `organization_id`      | string  |     ✅    | `"10234695"`                                                 | The Zoho Invoice organization ID (X-com-zoho-invoice-organizationid header)                    |
| `tax_exemption_id`     | string  |          | `"982000000567890"`                                          | Tax exemption ID. Required if is\_taxable is false. Applicable for US, Canada, and India only. |
| `sat_item_key_code`    | string  |          | `"01010101"`                                                 | SAT Item Key Code from CFDI Catalogs. Mexico only.                                             |
| `item_tax_preferences` | array   |          | `[{"tax_id":"982000000037049","tax_specification":"intra"}]` | List of tax preferences with tax\_id and tax\_specification (intra/inter for India)            |

***

### `Zoho Invoice Create Project Comment`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter         | Type   | Required | Example                                    | Description                                                                 |
| ----------------- | ------ | :------: | ------------------------------------------ | --------------------------------------------------------------------------- |
| `project_id`      | string |     ✅    | `"3525328000000033014"`                    | Unique identifier of the project                                            |
| `description`     | string |     ✅    | `"This is a test comment created via API"` | A short note on the project details. Maximum length: 500 characters         |
| `organization_id` | string |     ✅    | `"60065671998"`                            | The Zoho Invoice organization ID (X-com-zoho-invoice-organizationid header) |

***

### `Zoho Invoice Create Recurring Invoice`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

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

***

### `Zoho Invoice Create Refund Credit Note Refunds`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter          | Type   | Required | Example                              | Description                                                                                |
| ------------------ | ------ | :------: | ------------------------------------ | ------------------------------------------------------------------------------------------ |
| `date`             | string |     ✅    | `"2026-02-17"`                       | Date of the refund in YYYY-MM-DD format                                                    |
| `amount`           | number |     ✅    | `50`                                 | Refund amount (must be greater than 0 and less than or equal to credit note balance)       |
| `description`      | string |          | `"Test refund for API verification"` | Description of the refund                                                                  |
| `refund_mode`      | string |     ✅    | `"cash"`                             | Mode of refund (e.g., cash, check, bank\_transfer, credit\_card)                           |
| `creditnote_id`    | string |     ✅    | `"3476910000000099080"`              | Unique identifier of the credit note to create a refund for                                |
| `organization_id`  | string |     ✅    | `"60064402512"`                      | Organization ID header required for multi-org accounts (X-com-zoho-invoice-organizationid) |
| `reference_number` | string |          | `"REF-TEST-001"`                     | Reference number for the refund                                                            |

***

### `Zoho Invoice Create Task`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

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

***

### `Zoho Invoice Create Tax`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter                 | Type   | Required | Example            | Description                                                                 |
| ------------------------- | ------ | :------: | ------------------ | --------------------------------------------------------------------------- |
| `tax_name`                | string |     ✅    | `"Test Sales Tax"` | Name of the tax to be created                                               |
| `tax_type`                | string |     ✅    | —                  | Type of tax: 'tax' for regular tax or 'compound\_tax' for compound tax      |
| `tax_factor`              | string |          | —                  | Tax factor (Mexico only).                                                   |
| `country_code`            | string |          | `"GB"`             | Two-letter country code (UK only)                                           |
| `tax_account_id`          | string |          | —                  | Tax account ID for withholding tax (Mexico only)                            |
| `tax_percentage`          | number |     ✅    | `8.5`              | Percentage rate for the tax                                                 |
| `organization_id`         | string |     ✅    | `"60064402512"`    | The Zoho Invoice organization ID (X-com-zoho-invoice-organizationid header) |
| `tax_authority_id`        | string |          | —                  | Unique identifier of the tax authority                                      |
| `tax_specific_type`       | string |          | —                  | Tax specific type for region-specific taxes.                                |
| `purchase_tax_account_id` | string |          | —                  | Purchase tax account ID for withholding tax (Mexico only)                   |

***

### `Zoho Invoice Create Tax Group`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

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

***

### `Zoho Invoice Create Time Entry`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter         | Type    | Required | Example                                              | Description                                                                                                            |
| ----------------- | ------- | :------: | ---------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
| `notes`           | string  |          | `"API testing time entry for endpoint verification"` | Notes or description for the time entry                                                                                |
| `task_id`         | string  |          | `"3525328000000033137"`                              | Task ID within the project                                                                                             |
| `user_id`         | string  |          | `"3525328000000032001"`                              | User ID who logged the time                                                                                            |
| `end_time`        | string  |          | `"12:00"`                                            | End time in HH:MM format (24-hour). Use with begin\_time instead of log\_time.                                         |
| `log_date`        | string  |     ✅    | `"2026-02-17"`                                       | Date of the time entry in YYYY-MM-DD format                                                                            |
| `log_time`        | string  |          | —                                                    | 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  |          | `"10:00"`                                            | Start time in HH:MM format (24-hour). Use with end\_time instead of log\_time.                                         |
| `project_id`      | string  |     ✅    | `"3525328000000033014"`                              | ID or name of the project to log time against                                                                          |
| `is_billable`     | boolean |          | —                                                    | Whether the time entry is billable to the customer                                                                     |
| `organization_id` | string  |     ✅    | `"60065671998"`                                      | The Zoho Invoice organization ID (X-com-zoho-invoice-organizationid header)                                            |

***

### `Zoho Invoice Create User`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

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

***

### `Zoho Invoice Delete Additional Address`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter         | Type   | Required | Example                 | Description                                                                     |
| ----------------- | ------ | :------: | ----------------------- | ------------------------------------------------------------------------------- |
| `address_id`      | string |     ✅    | `"3476910000000098326"` | Unique identifier of the address to delete.                                     |
| `contact_id`      | string |     ✅    | `"3476910000000098308"` | Unique identifier of the contact.                                               |
| `organization_id` | string |     ✅    | `"60064402512"`         | The Zoho organization ID. Must be passed as query parameter 'organization\_id'. |

***

### `Zoho Invoice Delete Contact`

Integration name: **ZOHO\_INVOICE\_DELETE\_CONTACT**

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

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter         | Type   | Required | Example             | Description                                                                     |
| ----------------- | ------ | :------: | ------------------- | ------------------------------------------------------------------------------- |
| `contact_id`      | string |     ✅    | `"460000000026049"` | Unique identifier of the contact to delete.                                     |
| `organization_id` | string |     ✅    | `"60064402512"`     | The Zoho organization ID. Must be passed as query parameter 'organization\_id'. |

***

### `Zoho Invoice Delete Contact Person`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter           | Type   | Required | Example             | Description                                                                             |
| ------------------- | ------ | :------: | ------------------- | --------------------------------------------------------------------------------------- |
| `organization_id`   | string |     ✅    | `"60064402512"`     | The Zoho organization ID. Must be passed as header 'X-com-zoho-invoice-organizationid'. |
| `contact_person_id` | string |     ✅    | `"460000000026051"` | Unique identifier of the contact person to delete.                                      |

***

### `Zoho Invoice Delete Credit Notes Applied To Invoice`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter               | Type   | Required | Example                 | Description                                                                                             |
| ----------------------- | ------ | :------: | ----------------------- | ------------------------------------------------------------------------------------------------------- |
| `creditnote_id`         | string |     ✅    | `"3476910000000071320"` | Unique identifier of the credit note.                                                                   |
| `organization_id`       | string |     ✅    | `"60064402512"`         | Organization ID to which the credit note belongs. Required when user belongs to multiple organizations. |
| `creditnote_invoice_id` | string |     ✅    | `"3476910000000071645"` | Unique identifier of the credit note invoice to be removed.                                             |

***

### `Zoho Invoice Delete Currency`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter         | Type   | Required | Example                 | Description                                                                                        |
| ----------------- | ------ | :------: | ----------------------- | -------------------------------------------------------------------------------------------------- |
| `currency_id`     | string |     ✅    | `"3525328000000032318"` | Unique identifier of the currency to delete.                                                       |
| `organization_id` | string |     ✅    | `"60065671998"`         | The Zoho Invoice organization ID. Required to identify which organization the currency belongs to. |

***

### `Zoho Invoice Delete Customer Payment`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

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

***

### `Zoho Invoice Delete Employee`

Integration name: **ZOHO\_INVOICE\_DELETE\_EMPLOYEE**

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

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

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

***

### `Zoho Invoice Delete Estimate Comment`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter         | Type   | Required | Example                 | Description                                                                             |
| ----------------- | ------ | :------: | ----------------------- | --------------------------------------------------------------------------------------- |
| `comment_id`      | string |     ✅    | `"3476910000000099364"` | Unique identifier of the comment to delete.                                             |
| `estimate_id`     | string |     ✅    | `"3476910000000098112"` | Unique identifier of the estimate.                                                      |
| `organization_id` | string |     ✅    | `"60064402512"`         | The Zoho Invoice organization ID. Required when user belongs to multiple organizations. |

***

### `Zoho Invoice Delete Estimates`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter         | Type   | Required | Example                 | Description                                                                                                                        |
| ----------------- | ------ | :------: | ----------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| `estimate_ids`    | string |     ✅    | `"3476910000000099368"` | 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 |     ✅    | `"60064402512"`         | The Zoho Invoice organization ID. Required when user belongs to multiple organizations.                                            |

***

### `Zoho Invoice Delete Expense`

Integration name: **ZOHO\_INVOICE\_DELETE\_EXPENSE**

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

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

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

***

### `Zoho Invoice Delete Expense Category`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

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

***

### `Zoho Invoice Delete Invoice`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

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

***

### `Zoho Invoice Delete Invoice Attachment`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

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

***

### `Zoho Invoice Delete Invoice Comment`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter         | Type   | Required | Example                 | Description                                                                             |
| ----------------- | ------ | :------: | ----------------------- | --------------------------------------------------------------------------------------- |
| `comment_id`      | string |     ✅    | `"3525328000000032399"` | Unique identifier of the comment to delete.                                             |
| `invoice_id`      | string |     ✅    | `"3525328000000033044"` | Unique identifier of the invoice.                                                       |
| `organization_id` | string |     ✅    | `"60065671998"`         | The Zoho Invoice organization ID. Required when user belongs to multiple organizations. |

***

### `Zoho Invoice Delete Invoice Expense Receipt`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter         | Type   | Required | Example                 | Description                                                       |
| ----------------- | ------ | :------: | ----------------------- | ----------------------------------------------------------------- |
| `expense_id`      | string |     ✅    | `"3525328000000033107"` | Unique identifier of the expense whose receipt should be deleted. |
| `organization_id` | string |     ✅    | `"60065671998"`         | The Zoho Invoice organization ID. Required as query parameter.    |

***

### `Zoho Invoice Delete Item`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

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

***

### `Zoho Invoice Delete Project`

Integration name: **ZOHO\_INVOICE\_DELETE\_PROJECT**

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

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

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

***

### `Zoho Invoice Delete Project Comment`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter         | Type   | Required | Example             | Description                                                                             |
| ----------------- | ------ | :------: | ------------------- | --------------------------------------------------------------------------------------- |
| `comment_id`      | string |     ✅    | `"460000000044027"` | Unique identifier of the comment to delete.                                             |
| `project_id`      | string |     ✅    | `"460000000044019"` | Unique identifier of the project.                                                       |
| `organization_id` | string |     ✅    | `"60064402512"`     | The Zoho Invoice organization ID. Required when user belongs to multiple organizations. |

***

### `Zoho Invoice Delete Setting Taxes`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter         | Type   | Required | Example                 | Description                                                                                   |
| ----------------- | ------ | :------: | ----------------------- | --------------------------------------------------------------------------------------------- |
| `tax_id`          | string |     ✅    | `"3476910000000099439"` | Unique identifier of the tax to delete.                                                       |
| `organization_id` | string |     ✅    | `"60064402512"`         | The Zoho Invoice organization ID. Required to identify which organization the tax belongs to. |

***

### `Zoho Invoice Delete Task`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter         | Type   | Required | Example                 | Description                                                                             |
| ----------------- | ------ | :------: | ----------------------- | --------------------------------------------------------------------------------------- |
| `task_id`         | string |     ✅    | `"3525328000000032405"` | Unique identifier of the task to delete.                                                |
| `project_id`      | string |     ✅    | `"3525328000000033014"` | Unique identifier of the project.                                                       |
| `organization_id` | string |     ✅    | `"60065671998"`         | The Zoho Invoice organization ID. Must be passed as query parameter 'organization\_id'. |

***

### `Zoho Invoice Delete Time Entry`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

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

***

### `Zoho Invoice Delete User`

Integration name: **ZOHO\_INVOICE\_DELETE\_USER**

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

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

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

***

### `Zoho Invoice Disable Contact Payment Reminders`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

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

***

### `Zoho Invoice Disable Invoice Payment Reminder`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

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

***

### `Zoho Invoice Email Contact Statement`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter         | Type   | Required | Example                 | Description                                                                                                                                             |
| ----------------- | ------ | :------: | ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `end_date`        | string |          | `"2024-01-31"`          | End date for the statement period. Date format: yyyy-mm-dd                                                                                              |
| `contact_id`      | string |     ✅    | `"3476910000000082231"` | Unique identifier of the contact to send the statement to.                                                                                              |
| `start_date`      | string |          | `"2024-01-01"`          | 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 |     ✅    | `"60064402512"`         | The Zoho organization ID. Required for authentication.                                                                                                  |

***

### `Zoho Invoice Email Estimate`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter                | Type    | Required | Example                                     | Description                                                                         |
| ------------------------ | ------- | :------: | ------------------------------------------- | ----------------------------------------------------------------------------------- |
| `body`                   | string  |          | —                                           | Body content of the email. If not provided, a default template will be used.        |
| `subject`                | string  |          | —                                           | Subject line for the email. If not provided, a default subject will be used.        |
| `cc_mail_ids`            | array   |          | `["manager@example.com"]`                   | List of email addresses to CC on the estimate email.                                |
| `estimate_id`            | string  |     ✅    | `"982000000567011"`                         | Unique identifier of the estimate to email.                                         |
| `to_mail_ids`            | array   |     ✅    | `["test@example.com","client@example.com"]` | List of recipient email addresses. At least one email address is required.          |
| `organization_id`        | string  |     ✅    | `"60064402512"`                             | The Zoho Invoice organization ID. Required for all Zoho Invoice API calls.          |
| `send_from_org_email_id` | boolean |          | —                                           | Whether to send the email from the organization's email address. Defaults to false. |

***

### `Zoho Invoice Email Invoice`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter                 | Type    | Required | Example                                                    | Description                                                                          |
| ------------------------- | ------- | :------: | ---------------------------------------------------------- | ------------------------------------------------------------------------------------ |
| `body`                    | string  |          | —                                                          | Body content of the email. If not provided, default template will be used.           |
| `subject`                 | string  |          | —                                                          | Subject of the email. If not provided, default subject will be used.                 |
| `invoice_id`              | string  |     ✅    | `"982000000567114"`                                        | Unique identifier of the invoice to email                                            |
| `cc_mail_ids`             | array   |          | `["manager@example.com"]`                                  | Array of email addresses to be CC'd                                                  |
| `to_mail_ids`             | array   |     ✅    | `["frank.johnson@anothertest.com","john.doe@example.com"]` | Array of email addresses of the recipients. At least one email address is required.  |
| `organization_id`         | string  |     ✅    | `"60064402512"`                                            | The Zoho Invoice organization ID (sent as query parameter)                           |
| `send_attachment`         | boolean |          | —                                                          | Send the invoice attachment along with the email                                     |
| `send_from_org_email_id`  | boolean |          | —                                                          | Boolean to trigger email from organization's email address instead of default sender |
| `send_customer_statement` | boolean |          | —                                                          | Send customer statement PDF along with the email                                     |

***

### `Zoho Invoice Email Multiple Estimates`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

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

***

### `Zoho Invoice Enable Invoice Payment Reminder`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

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

***

### `Zoho Invoice Enable Payment Reminders`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

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

***

### `Zoho Invoice Enable Portal Access`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter         | Type   | Required | Example                                     | Description                                                                                              |
| ----------------- | ------ | :------: | ------------------------------------------- | -------------------------------------------------------------------------------------------------------- |
| `contact_id`      | string |     ✅    | `"460000000026049"`                         | Unique identifier of the contact for which to enable portal access                                       |
| `contact_persons` | array  |     ✅    | `[{"contact_person_id":"460000000026051"}]` | Array of contact person objects containing contact\_person\_id. At least one contact person is required. |
| `organization_id` | string |     ✅    | `"60065671998"`                             | The Zoho organization ID. Required for authentication.                                                   |

***

### `Zoho Invoice Export Invoices Bulk`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter         | Type   | Required | Example                                                         | Description                                                                                    |
| ----------------- | ------ | :------: | --------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- |
| `invoice_ids`     | string |     ✅    | `"3476910000000097030,3476910000000082362,3476910000000070440"` | Comma-separated invoice IDs to export as PDF (e.g., '3476910000000097030,3476910000000082362') |
| `organization_id` | string |     ✅    | `"60065671998"`                                                 | The Zoho Invoice organization ID. Required to identify the organization.                       |

***

### `Zoho Invoice Get All Tasks`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

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

***

### `Zoho Invoice Get Client Review`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter         | Type   | Required | Example             | Description                                                                             |
| ----------------- | ------ | :------: | ------------------- | --------------------------------------------------------------------------------------- |
| `comment_id`      | string |     ✅    | `"460000000053131"` | Unique identifier of the client review (comment) to retrieve.                           |
| `contact_id`      | string |          | `"460000000026049"` | Unique ID of a particular contact to filter the review by.                              |
| `organization_id` | string |     ✅    | `"60064402512"`     | The Zoho Invoice organization ID. Must be passed as query parameter 'organization\_id'. |

***

### `Zoho Invoice Get Contact`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter         | Type   | Required | Example                 | Description                                            |
| ----------------- | ------ | :------: | ----------------------- | ------------------------------------------------------ |
| `contact_id`      | string |     ✅    | `"3476910000000082231"` | Unique identifier of the contact to retrieve.          |
| `organization_id` | string |     ✅    | `"60064402512"`         | The Zoho organization ID. Required for authentication. |

***

### `Zoho Invoice Get Contact Addresses`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter         | Type   | Required | Example                 | Description                                                                     |
| ----------------- | ------ | :------: | ----------------------- | ------------------------------------------------------------------------------- |
| `contact_id`      | string |     ✅    | `"3476910000000082231"` | Unique identifier of the contact.                                               |
| `organization_id` | string |     ✅    | `"60064402512"`         | The Zoho organization ID. Must be passed as query parameter 'organization\_id'. |

***

### `Zoho Invoice Get Contact Person`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter           | Type   | Required | Example                 | Description                                                                     |
| ------------------- | ------ | :------: | ----------------------- | ------------------------------------------------------------------------------- |
| `contact_id`        | string |     ✅    | `"3476910000000048002"` | Unique identifier of the contact.                                               |
| `organization_id`   | string |     ✅    | `"60064402512"`         | The Zoho organization ID. Required when user belongs to multiple organizations. |
| `contact_person_id` | string |     ✅    | `"3476910000000070109"` | Unique identifier of the contact person.                                        |

***

### `Zoho Invoice Get Credit Note`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

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

***

### `Zoho Invoice Get Credit Note Email History`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

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

***

### `Zoho Invoice Get Credit Note Refund`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter              | Type   | Required | Example                 | Description                                                                             |
| ---------------------- | ------ | :------: | ----------------------- | --------------------------------------------------------------------------------------- |
| `creditnote_id`        | string |     ✅    | `"3476910000000070037"` | Unique identifier of the credit note.                                                   |
| `organization_id`      | string |     ✅    | `"60064402512"`         | The Zoho Invoice organization ID. Required when user belongs to multiple organizations. |
| `creditnote_refund_id` | string |     ✅    | `"3476910000000069545"` | Unique identifier of the credit note refund.                                            |

***

### `Zoho Invoice Get Expense`

Integration name: **ZOHO\_INVOICE\_GET\_EXPENSE**

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

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter         | Type   | Required | Example                 | Description                                            |
| ----------------- | ------ | :------: | ----------------------- | ------------------------------------------------------ |
| `expense_id`      | string |     ✅    | `"3476910000000098784"` | Unique identifier of the expense to retrieve.          |
| `organization_id` | string |     ✅    | `"60064402512"`         | The Zoho organization ID. Required for authentication. |

***

### `Zoho Invoice Get Invoice`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

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

***

### `Zoho Invoice Get Invoice Attachment`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter         | Type    | Required | Example                 | Description                          |
| ----------------- | ------- | :------: | ----------------------- | ------------------------------------ |
| `preview`         | boolean |          | —                       | Get the thumbnail of the attachment. |
| `invoice_id`      | string  |     ✅    | `"3525328000000033072"` | Unique identifier of the invoice.    |
| `organization_id` | string  |     ✅    | `"60065671998"`         | The Zoho Invoice organization ID.    |

***

### `Zoho Invoice Get Invoice Email Content`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter           | Type   | Required | Example                 | Description                                                                                                                                                                                                                                  |
| ------------------- | ------ | :------: | ----------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `invoice_id`        | string |     ✅    | `"3476910000000098635"` | Unique identifier of the invoice to get email content for                                                                                                                                                                                    |
| `organization_id`   | string |     ✅    | `"60064402512"`         | The Zoho Invoice organization ID (sent as X-com-zoho-invoice-organizationid header)                                                                                                                                                          |
| `email_template_id` | string |          | —                       | 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. |

***

### `Zoho Invoice Get Item`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

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

***

### `Zoho Invoice Get Payment Reminder Mail Content`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

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

***

### `Zoho Invoice Get Price List`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

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

***

### `Zoho Invoice Get Project`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

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

***

### `Zoho Invoice Get Project User`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter         | Type   | Required | Example             | Description                                                    |
| ----------------- | ------ | :------: | ------------------- | -------------------------------------------------------------- |
| `user_id`         | string |     ✅    | `"460000000024003"` | Unique identifier of the user.                                 |
| `project_id`      | string |     ✅    | `"460000000044019"` | Unique identifier of the project.                              |
| `organization_id` | string |     ✅    | `"60065671998"`     | The Zoho Invoice organization ID. Required for authentication. |

***

### `Zoho Invoice Get Recurring Invoice`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

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

***

### `Zoho Invoice Get Statement Mail Content`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter         | Type   | Required | Example                 | Description                                                                                                                                      |
| ----------------- | ------ | :------: | ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| `end_date`        | string |          | `"2024-01-31"`          | End date for the statement period. Date format: yyyy-mm-dd                                                                                       |
| `contact_id`      | string |     ✅    | `"3476910000000082231"` | Unique identifier of the contact to retrieve statement mail content for.                                                                         |
| `start_date`      | string |          | `"2024-01-01"`          | 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 |     ✅    | `"60064402512"`         | The Zoho Invoice organization ID. This is required to identify which organization's data to retrieve.                                            |

***

### `Zoho Invoice Get Task`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter         | Type   | Required | Example                 | Description                                                                             |
| ----------------- | ------ | :------: | ----------------------- | --------------------------------------------------------------------------------------- |
| `task_id`         | string |     ✅    | `"3525328000000033137"` | Unique identifier of the task to retrieve.                                              |
| `project_id`      | string |     ✅    | `"3525328000000033014"` | Unique identifier of the project containing the task.                                   |
| `organization_id` | string |     ✅    | `"60065671998"`         | The Zoho Invoice organization ID. Required when user belongs to multiple organizations. |

***

### `Zoho Invoice Get Tax`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter         | Type   | Required | Example             | Description                                                                             |
| ----------------- | ------ | :------: | ------------------- | --------------------------------------------------------------------------------------- |
| `tax_id`          | string |     ✅    | `"982000000566009"` | Unique identifier of the tax to retrieve.                                               |
| `organization_id` | string |          | `"60064402512"`     | The Zoho Invoice organization ID. Required when user belongs to multiple organizations. |

***

### `Zoho Invoice Get Tax Group`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter         | Type   | Required | Example             | Description                                                                 |
| ----------------- | ------ | :------: | ------------------- | --------------------------------------------------------------------------- |
| `tax_group_id`    | string |     ✅    | `"982000000566009"` | Unique identifier of the tax group to retrieve.                             |
| `organization_id` | string |     ✅    | `"60064402512"`     | The Zoho Invoice organization ID. Required for multi-organization accounts. |

***

### `Zoho Invoice Get Time Entry`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

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

***

### `Zoho Invoice Inactivate Project`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

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

***

### `Zoho Invoice List Child Expenses Created`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter              | Type    | Required | Example             | Description                                                                                 |
| ---------------------- | ------- | :------: | ------------------- | ------------------------------------------------------------------------------------------- |
| `page`                 | integer |          | `1`                 | Page number to be fetched. Default value is 1.                                              |
| `per_page`             | integer |          | `200`               | Number of records to be fetched per page. Default value is 200.                             |
| `sort_column`          | string  |          | —                   | Allowed sort columns for child expenses listing.                                            |
| `organization_id`      | string  |          | `"60064402512"`     | The Zoho Invoice organization ID. Required when the user belongs to multiple organizations. |
| `recurring_expense_id` | string  |     ✅    | `"982000000567240"` | Unique identifier of the recurring expense.                                                 |

***

### `Zoho Invoice List Client Reviews`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter         | Type    | Required | Example           | Description                                                                             |
| ----------------- | ------- | :------: | ----------------- | --------------------------------------------------------------------------------------- |
| `page`            | integer |          | `1`               | Page number to be fetched. Default value is 1.                                          |
| `per_page`        | integer |          | `200`             | Number of records to be fetched per page. Default value is 200.                         |
| `contact_id`      | integer |          | `460000000026049` | Unique ID of a particular contact to filter reviews.                                    |
| `organization_id` | string  |     ✅    | `"60064402512"`   | The Zoho Invoice organization ID. Must be passed as query parameter 'organization\_id'. |

***

### `Zoho Invoice List Contact Comments`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter         | Type    | Required | Example                 | Description                                                     |
| ----------------- | ------- | :------: | ----------------------- | --------------------------------------------------------------- |
| `page`            | integer |          | `1`                     | Page number to be fetched. Default value is 1.                  |
| `per_page`        | integer |          | `200`                   | Number of records to be fetched per page. Default value is 200. |
| `contact_id`      | string  |     ✅    | `"3476910000000082231"` | Unique identifier of the contact to retrieve comments for       |
| `organization_id` | string  |     ✅    | `"60064402512"`         | The Zoho Invoice organization ID                                |

***

### `Zoho Invoice List Contact Refunds`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter         | Type    | Required | Example                 | Description                                                                             |
| ----------------- | ------- | :------: | ----------------------- | --------------------------------------------------------------------------------------- |
| `page`            | integer |          | `1`                     | Page number to be fetched. Default value is 1.                                          |
| `per_page`        | integer |          | `200`                   | Number of records to be fetched per page. Default value is 200.                         |
| `contact_id`      | string  |     ✅    | `"3476910000000082231"` | Unique identifier of the contact whose refunds to retrieve                              |
| `organization_id` | string  |     ✅    | `"60064402512"`         | The Zoho Invoice organization ID. Required when user belongs to multiple organizations. |

***

### `Zoho Invoice List Contacts`

Integration name: **ZOHO\_INVOICE\_LIST\_CONTACTS**

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

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

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

***

### `Zoho Invoice List Credit Notes`

Integration name: **ZOHO\_INVOICE\_LIST\_CREDIT\_NOTES**

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

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter           | Type    | Required | Example              | Description                                                                                                  |
| ------------------- | ------- | :------: | -------------------- | ------------------------------------------------------------------------------------------------------------ |
| `date`              | string  |          | `"2016-06-05"`       | The date on which credit note is raised (yyyy-mm-dd)                                                         |
| `page`              | integer |          | `1`                  | Page number to be fetched. Default value is 1                                                                |
| `total`             | number  |          | `450`                | Total credits raised in this credit note                                                                     |
| `status`            | string  |          | `"open"`             | Status of the credit note                                                                                    |
| `item_id`           | string  |          | `"90300000081501"`   | Unique string generated for the item to which a refund is to be made                                         |
| `per_page`          | integer |          | `200`                | Number of records to be fetched per page. Default value is 200                                               |
| `filter_by`         | string  |          | —                    | Filter credit notes by status                                                                                |
| `item_name`         | string  |          | `"kit"`              | Search credit notes by item name                                                                             |
| `customer_id`       | string  |          | `"903000000000099"`  | Customer ID of the customer for whom the credit note is raised                                               |
| `search_text`       | string  |          | —                    | Search credit notes by credit note number or customer name or credit note reference number                   |
| `sort_column`       | string  |          | `"created_time"`     | Sort credit notes by specified column                                                                        |
| `customer_name`     | string  |          | `"Bowman Furniture"` | Name of the customer to whom the credit note is raised                                                       |
| `organization_id`   | string  |     ✅    | `"60064402512"`      | The Zoho Invoice organization ID to list credit notes from                                                   |
| `item_description`  | string  |          | —                    | Description for the item. Variants item\_description\_startswith and item\_description\_contains             |
| `reference_number`  | string  |          | `"INV-384"`          | Reference number generated for the payment. A string of your choice can also be used as the reference number |
| `creditnote_number` | string  |          | `"CN-29"`            | Unique number generated (starts with CN) which will be displayed in the interface and credit notes           |

***

### `Zoho Invoice List Currencies`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter         | Type    | Required | Example         | Description                                                                                       |
| ----------------- | ------- | :------: | --------------- | ------------------------------------------------------------------------------------------------- |
| `page`            | integer |          | `1`             | Page number for pagination, starts at 1                                                           |
| `per_page`        | integer |          | `50`            | Number of currencies per page, max 200                                                            |
| `organization_id` | string  |     ✅    | `"60064402512"` | The Zoho Invoice organization ID. Required to identify which organization the request applies to. |

***

### `Zoho Invoice List Customer Payment Refunds`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter             | Type    | Required | Example           | Description                                                                             |
| --------------------- | ------- | :------: | ----------------- | --------------------------------------------------------------------------------------- |
| `page`                | integer |          | `1`               | Page number to be fetched. Default value is 1.                                          |
| `per_page`            | integer |          | `200`             | Number of records to be fetched per page. Default value is 200.                         |
| `organization_id`     | string  |     ✅    | `"60064402512"`   | The Zoho Invoice organization ID. Required when user belongs to multiple organizations. |
| `customer_payment_id` | string  |     ✅    | `"9030000079467"` | Unique identifier of the customer payment whose refunds to retrieve.                    |

***

### `Zoho Invoice List Employees`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter         | Type    | Required | Example         | Description                                                                    |
| ----------------- | ------- | :------: | --------------- | ------------------------------------------------------------------------------ |
| `page`            | integer |          | `1`             | Page number to be fetched. Default value is 1.                                 |
| `per_page`        | integer |          | `200`           | Number of records to be fetched per page. Default value is 200.                |
| `organization_id` | string  |     ✅    | `"60064402512"` | The organization ID. Required when the user belongs to multiple organizations. |

***

### `Zoho Invoice List Estimates`

Integration name: **ZOHO\_INVOICE\_LIST\_ESTIMATES**

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

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter           | Type    | Required | Example           | Description                                                                 |
| ------------------- | ------- | :------: | ----------------- | --------------------------------------------------------------------------- |
| `page`              | integer |          | `1`               | Page number to be fetched. Default value is 1.                              |
| `per_page`          | integer |          | `200`             | Number of records to be fetched per page. Default value is 200.             |
| `organization_id`   | string  |     ✅    | `"10234695"`      | The Zoho Invoice organization ID (X-com-zoho-invoice-organizationid header) |
| `zcrm_potential_id` | integer |          | `460000000026049` | Potential ID of a Deal in CRM to filter estimates                           |

***

### `Zoho Invoice List Expense Categories`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter         | Type    | Required | Example      | Description                                                                 |
| ----------------- | ------- | :------: | ------------ | --------------------------------------------------------------------------- |
| `page`            | integer |          | `1`          | Page number to be fetched. Default value is 1.                              |
| `per_page`        | integer |          | `200`        | Number of records to be fetched per page. Default value is 200.             |
| `filter_by`       | string  |          | —            | Filter options for expense categories by status.                            |
| `sort_column`     | string  |          | —            | Sort column options for expense categories.                                 |
| `organization_id` | string  |     ✅    | `"10234695"` | The Zoho Invoice organization ID (X-com-zoho-invoice-organizationid header) |

***

### `Zoho Invoice List Expense Comments`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter         | Type   | Required | Example                 | Description                                               |
| ----------------- | ------ | :------: | ----------------------- | --------------------------------------------------------- |
| `expense_id`      | string |     ✅    | `"3476910000000098784"` | Unique identifier of the expense to retrieve comments for |
| `organization_id` | string |     ✅    | `"60064402512"`         | The Zoho organization ID. Required for authentication.    |

***

### `Zoho Invoice List Expenses`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

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

***

### `Zoho Invoice List Invoice Comments`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter         | Type   | Required | Example                 | Description                                               |
| ----------------- | ------ | :------: | ----------------------- | --------------------------------------------------------- |
| `invoice_id`      | string |     ✅    | `"3476910000000098635"` | Unique identifier of the invoice to retrieve comments for |
| `organization_id` | string |     ✅    | `"10234695"`            | Unique identifier of the organization                     |

***

### `Zoho Invoice List Invoice Payments`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

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

***

### `Zoho Invoice List Invoices`

Integration name: **ZOHO\_INVOICE\_LIST\_INVOICES**

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

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

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

***

### `Zoho Invoice List Invoices Credited`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

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

***

### `Zoho Invoice List Items`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

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

***

### `Zoho Invoice List Organizations`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. *No parameters required.*

***

### `Zoho Invoice List Payments`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter          | Type    | Required | Example                 | Description                                              |
| ------------------ | ------- | :------: | ----------------------- | -------------------------------------------------------- |
| `mode`             | string  |          | `"Cash"`                | Filter by payment mode (e.g., 'Cash', 'Credit Card')     |
| `page`             | integer |          | `1`                     | Page number for pagination, starts at 1                  |
| `date_end`         | string  |          | `"2021-12-31"`          | Filter payments made on or before this date (YYYY-MM-DD) |
| `per_page`         | integer |          | `50`                    | Number of payments per page, maximum 200                 |
| `filter_by`        | string  |          | —                       | Filter payments by payment mode                          |
| `date_start`       | string  |          | `"2021-01-01"`          | Filter payments made on or after this date (YYYY-MM-DD)  |
| `invoice_id`       | string  |          | `"1714406000000099002"` | Filter payments for a specific invoice by ID             |
| `sort_order`       | string  |          | —                       | Sort order: 'A' for ascending, 'D' for descending        |
| `customer_id`      | string  |          | `"1714406000000099001"` | Filter payments for a specific customer by ID            |
| `sort_column`      | string  |          | —                       | Column to sort by                                        |
| `payment_number`   | string  |          | `"P-0001"`              | Filter by payment number                                 |
| `reference_number` | string  |          | `"REF1234"`             | Filter by reference number                               |

***

### `Zoho Invoice List Price Lists`

Integration name: **ZOHO\_INVOICE\_LIST\_PRICE\_LISTS**

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

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter         | Type    | Required | Example         | Description                                                      |
| ----------------- | ------- | :------: | --------------- | ---------------------------------------------------------------- |
| `page`            | integer |          | `1`             | Page number to be fetched. Default value is 1.                   |
| `per_page`        | integer |          | `200`           | Number of records to be fetched per page. Default value is 200.  |
| `organization_id` | string  |     ✅    | `"60064402512"` | ID of the organization. Required for all Zoho Invoice API calls. |

***

### `Zoho Invoice List Project Comments`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter         | Type   | Required | Example             | Description                      |
| ----------------- | ------ | :------: | ------------------- | -------------------------------- |
| `project_id`      | string |     ✅    | `"460000000044019"` | Unique identifier of the project |
| `organization_id` | string |     ✅    | `"60065671998"`     | The Zoho Invoice organization ID |

***

### `Zoho Invoice List Project Invoices`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter         | Type    | Required | Example             | Description                                                                             |
| ----------------- | ------- | :------: | ------------------- | --------------------------------------------------------------------------------------- |
| `page`            | integer |          | `1`                 | Page number to be fetched. Default value is 1                                           |
| `per_page`        | integer |          | `200`               | Number of records to be fetched per page. Default value is 200                          |
| `project_id`      | string  |     ✅    | `"460000000044019"` | Unique identifier of the project to retrieve invoices for                               |
| `sort_column`     | string  |          | —                   | Sort column options for listing project invoices.                                       |
| `organization_id` | string  |     ✅    | `"60064402512"`     | The Zoho Invoice organization ID. Required when user belongs to multiple organizations. |

***

### `Zoho Invoice List Projects`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter         | Type    | Required | Example             | Description                                                                     |
| ----------------- | ------- | :------: | ------------------- | ------------------------------------------------------------------------------- |
| `page`            | integer |          | `1`                 | Page number to be fetched. Default value is 1.                                  |
| `per_page`        | integer |          | `200`               | Number of records to be fetched per page. Default value is 200.                 |
| `filter_by`       | string  |          | `"Status.All"`      | Filter options for project status.                                              |
| `customer_id`     | string  |          | `"460000000044001"` | Unique ID of the customer to filter projects                                    |
| `sort_column`     | string  |          | `"created_time"`    | Sort column options for projects.                                               |
| `organization_id` | string  |     ✅    | `"60064402512"`     | The Zoho organization ID. Must be passed as query parameter 'organization\_id'. |

***

### `Zoho Invoice List Project Users`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter         | Type   | Required | Example             | Description                                                    |
| ----------------- | ------ | :------: | ------------------- | -------------------------------------------------------------- |
| `project_id`      | string |     ✅    | `"460000000044019"` | Unique identifier of the project.                              |
| `organization_id` | string |     ✅    | `"60065671998"`     | The Zoho Invoice organization ID. Required for authentication. |

***

### `Zoho Invoice List Recurring Invoices`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter         | Type    | Required | Example          | Description                                                                                                                                                                                            |
| ----------------- | ------- | :------: | ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `page`            | integer |          | `1`              | Page number to be fetched. Default value is 1.                                                                                                                                                         |
| `per_page`        | integer |          | `200`            | Number of records to be fetched per page. Default value is 200.                                                                                                                                        |
| `filter_by`       | string  |          | —                | 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  |          | —                | Search invoices by invoice number, purchase order, or customer name                                                                                                                                    |
| `sort_column`     | string  |          | `"created_time"` | Sort based on column value (e.g., created\_time, customer\_name)                                                                                                                                       |
| `organization_id` | string  |          | `"60064402512"`  | The unique ID of the organization. Required when user belongs to multiple organizations.                                                                                                               |

***

### `Zoho Invoice List Retainer Invoices`

Integration name: **ZOHO\_INVOICE\_LIST\_RETAINER\_INVOICES**

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

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter         | Type    | Required | Example         | Description                                                                              |
| ----------------- | ------- | :------: | --------------- | ---------------------------------------------------------------------------------------- |
| `page`            | integer |          | `1`             | Page number for pagination, starts at 1                                                  |
| `print`           | boolean |          | —               | Print the exported pdf                                                                   |
| `per_page`        | integer |          | `200`           | Number of retainer invoices per page. Default value is 200.                              |
| `filter_by`       | string  |          | —               | Filter retainer invoices by status or payment expected date                              |
| `sort_order`      | string  |          | —               | Sort order: 'A' for ascending, 'D' for descending                                        |
| `sort_column`     | string  |          | —               | Sort retainer invoices by specified column                                               |
| `organization_id` | string  |          | `"60064402512"` | The unique ID of the organization. Required when user belongs to multiple organizations. |

***

### `Zoho Invoice List Retainer Invoice Templates`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

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

***

### `Zoho Invoice List Users`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

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

***

### `Zoho Invoice Mark Contact Active`

Integration name: **ZOHO\_INVOICE\_MARK\_CONTACT\_ACTIVE**

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

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

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

***

### `Zoho Invoice Mark Contact Inactive`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter         | Type   | Required | Example                 | Description                                                                     |
| ----------------- | ------ | :------: | ----------------------- | ------------------------------------------------------------------------------- |
| `contact_id`      | string |     ✅    | `"3476910000000070695"` | Unique identifier of the contact to mark as inactive.                           |
| `organization_id` | string |     ✅    | `"60064402512"`         | The Zoho organization ID. Must be passed as query parameter 'organization\_id'. |

***

### `Zoho Invoice Mark Contact Person As Primary`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

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

***

### `Zoho Invoice Mark Estimate As Declined`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

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

***

### `Zoho Invoice Mark Expense Category Active`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

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

***

### `Zoho Invoice Mark Invoice As Sent`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

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

***

### `Zoho Invoice Mark Invoice As Void`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

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

***

### `Zoho Invoice Mark Item As Inactive`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

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

***

### `Zoho Invoice Mark Retainer Invoice As Sent`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

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

***

### `Zoho Invoice Print Estimates`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

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

***

### `Zoho Invoice Print Invoices`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter         | Type   | Required | Example                                     | Description                                                                                  |
| ----------------- | ------ | :------: | ------------------------------------------- | -------------------------------------------------------------------------------------------- |
| `invoice_ids`     | string |     ✅    | `"3476910000000097030,3476910000000082362"` | Comma-separated list of invoice IDs to print. Maximum of 25 invoices can be printed at once. |
| `organization_id` | string |     ✅    | `"60065671998"`                             | The Zoho Invoice organization ID. Required to identify the organization.                     |

***

### `Zoho Invoice Refund Customer Payment`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter             | Type   | Required | Example                         | Description                                                                                                              |
| --------------------- | ------ | :------: | ------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| `date`                | string |     ✅    | `"2026-02-17"`                  | Date on which refund is made. Date Format \[yyyy-mm-dd]                                                                  |
| `amount`              | number |     ✅    | `10`                            | Amount to be refunded. Must be greater than 0.                                                                           |
| `description`         | string |          | `"Test refund for curl tester"` | Description or notes about the refund.                                                                                   |
| `refund_mode`         | string |          | `"cash"`                        | The method of refund (e.g., cash, check, bank\_transfer, credit\_card).                                                  |
| `payment_form`        | string |          | —                               | Mode of vendor payment. This field is only applicable for Mexico.                                                        |
| `exchange_rate`       | number |          | `1`                             | Exchange rate for currency conversion. Default is 1.                                                                     |
| `organization_id`     | string |     ✅    | `"60064402512"`                 | Organization ID to associate the request with a specific organization. Sent as X-com-zoho-invoice-organizationid header. |
| `reference_number`    | string |          | `"REFUND-TEST-001"`             | Reference number for the refund.                                                                                         |
| `customer_payment_id` | string |     ✅    | `"3476910000000098806"`         | Unique identifier of the customer payment to refund.                                                                     |

***

### `Zoho Invoice Resume Recurring Invoice`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter              | Type   | Required | Example                 | Description                                                                             |
| ---------------------- | ------ | :------: | ----------------------- | --------------------------------------------------------------------------------------- |
| `organization_id`      | string |          | `"60064402512"`         | The Zoho Invoice organization ID. Required when user belongs to multiple organizations. |
| `recurring_invoice_id` | string |     ✅    | `"3476910000000099562"` | Unique identifier of the recurring invoice to resume.                                   |

***

### `Zoho Invoice Send Bulk Invoice Reminder`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

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

***

### `Zoho Invoice Send Contact Email`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter                 | Type    | Required | Example                                                                                       | Description                                                                                      |
| ------------------------- | ------- | :------: | --------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------ |
| `body`                    | string  |     ✅    | `"Dear Customer, Please find your customer statement attached. Thank you for your business."` | Body content of the email                                                                        |
| `subject`                 | string  |     ✅    | `"Customer Statement from Test"`                                                              | Subject line of the email                                                                        |
| `contact_id`              | string  |     ✅    | `"3476910000000099520"`                                                                       | Unique identifier of the contact to send email to                                                |
| `to_mail_ids`             | array   |     ✅    | `["testcontact@example.com"]`                                                                 | Array of email addresses to send the email to                                                    |
| `organization_id`         | string  |     ✅    | `"60064402512"`                                                                               | The Zoho organization ID. Required for authentication (X-com-zoho-invoice-organizationid header) |
| `send_customer_statement` | boolean |          | —                                                                                             | Send customer statement PDF with email                                                           |

***

### `Zoho Invoice Start Timer`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

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

***

### `Zoho Invoice Stop Recurring Invoice`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter              | Type   | Required | Example                 | Description                                                                             |
| ---------------------- | ------ | :------: | ----------------------- | --------------------------------------------------------------------------------------- |
| `organization_id`      | string |          | `"60064402512"`         | The Zoho Invoice organization ID. Required when user belongs to multiple organizations. |
| `recurring_invoice_id` | string |     ✅    | `"3476910000000099562"` | Unique identifier of the recurring invoice to stop.                                     |

***

### `Zoho Invoice Update Additional Address`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter         | Type   | Required | Example                 | Description                                                                 |
| ----------------- | ------ | :------: | ----------------------- | --------------------------------------------------------------------------- |
| `fax`             | string |          | `"+91-11-9876544"`      | Fax number                                                                  |
| `zip`             | string |          | `"110001"`              | Postal/zip code                                                             |
| `city`            | string |          | `"Delhi"`               | City name                                                                   |
| `phone`           | string |          | `"+91-11-9876543"`      | Phone number                                                                |
| `state`           | string |          | `"Delhi"`               | State name                                                                  |
| `address`         | string |          | `"456 Updated Avenue"`  | Primary address line, max 500 characters                                    |
| `country`         | string |          | `"India"`               | Country name                                                                |
| `street2`         | string |          | `"Floor 2"`             | Secondary address line                                                      |
| `attention`       | string |          | `"Jane Smith"`          | Contact person's name for the address                                       |
| `address_id`      | string |     ✅    | `"3525328000000033225"` | Unique identifier of the address to update                                  |
| `contact_id`      | string |     ✅    | `"3525328000000032532"` | Unique identifier of the contact to update the address for                  |
| `state_code`      | string |          | `"DL"`                  | State abbreviation                                                          |
| `organization_id` | string |     ✅    | `"60065671998"`         | The Zoho Invoice organization ID (X-com-zoho-invoice-organizationid header) |

***

### `Zoho Invoice Update Contact`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

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

***

### `Zoho Invoice Update Contact Person`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter           | Type    | Required | Example                    | Description                                                                             |
| ------------------- | ------- | :------: | -------------------------- | --------------------------------------------------------------------------------------- |
| `email`             | string  |          | `"john.smith@example.com"` | Email address of the contact person                                                     |
| `phone`             | string  |          | `"+1-555-0101"`            | Phone number of the contact person                                                      |
| `skype`             | string  |          | `"john.smith.skype"`       | Skype ID of the contact person                                                          |
| `mobile`            | string  |          | `"9876543210"`             | Mobile number of the contact person                                                     |
| `last_name`         | string  |          | `"Smith"`                  | Last name of the contact person                                                         |
| `contact_id`        | string  |     ✅    | `"3476910000000048002"`    | Identifier of the parent contact to which this contact person belongs                   |
| `department`        | string  |          | `"Operations"`             | Department in which the contact person works                                            |
| `first_name`        | string  |     ✅    | `"Jonathan"`               | First name of the contact person. Required field.                                       |
| `salutation`        | string  |          | `"Mr."`                    | Salutation for the contact person (e.g., Mr., Ms., Dr.)                                 |
| `designation`       | string  |          | `"Senior Manager"`         | Job title or designation of the contact person                                          |
| `enable_portal`     | boolean |          | —                          | Enable portal access for the contact person. Set to true to allow portal login.         |
| `organization_id`   | string  |     ✅    | `"60064402512"`            | The Zoho organization ID. Must be passed as header 'X-com-zoho-invoice-organizationid'. |
| `contact_person_id` | string  |     ✅    | `"3476910000000070228"`    | Unique identifier of the contact person to update.                                      |

***

### `Zoho Invoice Update Credit Note`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

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

***

### `Zoho Invoice Update Credit Note Template`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

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

***

### `Zoho Invoice Update Customer Payment Refund`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter             | Type   | Required | Example                                         | Description                                                                                |
| --------------------- | ------ | :------: | ----------------------------------------------- | ------------------------------------------------------------------------------------------ |
| `date`                | string |          | `"2026-02-17"`                                  | Date on which payment is made. Format \[yyyy-mm-dd]                                        |
| `amount`              | number |          | `12`                                            | Amount paid in the respective payment                                                      |
| `refund_id`           | string |     ✅    | `"3525328000000033335"`                         | Unique identifier of the refund to update.                                                 |
| `description`         | string |          | `"Updated refund amount and mode via API test"` | Details about the payment transaction                                                      |
| `refund_mode`         | string |          | `"check"`                                       | The method of refund (e.g., check, cash, bank\_transfer). Maximum length \[50]             |
| `payment_form`        | string |          | `"01"`                                          | Mode of payment (Mexico only)                                                              |
| `exchange_rate`       | number |          | `1`                                             | Exchange rate for currency conversion; defaults to 1                                       |
| `organization_id`     | string |     ✅    | `"60065671998"`                                 | Organization ID header required for multi-org accounts (X-com-zoho-invoice-organizationid) |
| `reference_number`    | string |          | `"REF-UPDATE-001"`                              | Reference number generated for the payment. Maximum length \[100]                          |
| `customer_payment_id` | string |     ✅    | `"3525328000000033291"`                         | Unique identifier of the customer payment.                                                 |

***

### `Zoho Invoice Update Estimate Shipping Address`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter         | Type   | Required | Example             | Description                                                                 |
| ----------------- | ------ | :------: | ------------------- | --------------------------------------------------------------------------- |
| `fax`             | string |          | `"+91-22-12345678"` | Fax number (optional)                                                       |
| `zip`             | string |     ✅    | `"400001"`          | Zip/Postal code for shipping address                                        |
| `city`            | string |     ✅    | `"Mumbai"`          | City for shipping address                                                   |
| `phone`           | string |          | `"+91-22-87654321"` | Phone number (optional)                                                     |
| `state`           | string |     ✅    | `"Maharashtra"`     | State/Province for shipping address                                         |
| `address`         | string |     ✅    | `"123 Test Street"` | Street address for shipping                                                 |
| `country`         | string |     ✅    | `"India"`           | Country for shipping address                                                |
| `street2`         | string |          | `"Apartment 5B"`    | Second address line (optional)                                              |
| `attention`       | string |          | `"John Doe"`        | Attention/contact name (optional)                                           |
| `estimate_id`     | string |     ✅    | `"982000000567011"` | Unique identifier of the estimate to update                                 |
| `organization_id` | string |     ✅    | `"60064402512"`     | The Zoho Invoice organization ID (X-com-zoho-invoice-organizationid header) |

***

### `Zoho Invoice Write Off Invoice`

Integration name: **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.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter         | Type   | Required | Example                 | Description                                                                     |
| ----------------- | ------ | :------: | ----------------------- | ------------------------------------------------------------------------------- |
| `invoice_id`      | string |     ✅    | `"3476910000000037394"` | Unique identifier of the invoice to write off                                   |
| `organization_id` | string |     ✅    | `"60064402512"`         | The Zoho organization ID. Must be passed as query parameter 'organization\_id'. |

***


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.toolhouse.ai/toolhouse/integrations/zoho-invoice.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
