> Markdown versions of all pages of this connector library are available by appending `.md` to the page URL. For the full index of connectors, see [llms.txt](https://connectors.appmixer.com/llms.txt).

# appmixer.zoho.books.NewInvoice

- Component: `appmixer.zoho.books.NewInvoice`
- Kind: Trigger
- Version: 1.0.0
- Visibility: Public
- Connector: [appmixer.zoho.books 1.3.0](https://connectors.appmixer.com/connector/appmixer.zoho.books/1.3.0.md)
- Component page: <https://connectors.appmixer.com/connector/appmixer.zoho.books/1.3.0/component/appmixer.zoho.books.NewInvoice>

Triggers when a new invoice is created in Zoho Books, or optionally when an invoice is created or updated (e.g. sent, paid or voided).

## Properties

| Field | Type | Description |
| --- | --- | --- |
| Organization ID (`organizationId`) | text | Select the organization to watch for new invoices, or enter its ID. |
| Events (`events`) | select | Trigger for new invoices only, or also every time an invoice changes: status changes such as sent, paid, overdue or void, and edits. |
| Status (`status`) | select | Optionally only trigger for invoices with the selected status. |

## Output ports

### Port `out`

| Field | Type | Description |
| --- | --- | --- |
| Invoice ID (`invoice_id`) | string | - |
| Invoice Number (`invoice_number`) | string | - |
| Date (`date`) | string | - |
| Status (`status`) | string | - |
| Total (`total`) | number | - |
| Balance (`balance`) | number | - |
| Currency Code (`currency_code`) | string | - |
| Customer ID (`customer_id`) | string | - |
| Customer Name (`customer_name`) | string | - |
| Email (`email`) | string | - |
| Billing Address (`billing_address`) | object | - |
| Line Items (`line_items`) | array | - |
| Created Time (`created_time`) | string | - |
| Last Modified Time (`last_modified_time`) | string | - |

## Full metadata (component.json)

```json
{
  "name": "appmixer.zoho.books.NewInvoice",
  "author": "Appmixer <info@appmixer.com>",
  "description": "Triggers when a new invoice is created in Zoho Books, or optionally when an invoice is created or updated (e.g. sent, paid or voided).",
  "version": "1.0.0",
  "tick": true,
  "auth": {
    "service": "appmixer:zoho:books",
    "scope": [
      "ZohoBooks.invoices.READ"
    ]
  },
  "quota": {
    "manager": "appmixer:zoho:books",
    "resources": "requests",
    "scope": {
      "userId": "{{userId}}"
    }
  },
  "properties": {
    "schema": {
      "type": "object",
      "properties": {
        "organizationId": {
          "type": "string"
        },
        "events": {
          "type": "string"
        },
        "status": {
          "type": "string"
        }
      },
      "required": [
        "organizationId"
      ]
    },
    "inspector": {
      "inputs": {
        "organizationId": {
          "type": "text",
          "label": "Organization ID",
          "index": 0,
          "tooltip": "Select the organization to watch for new invoices, or enter its ID.",
          "source": {
            "url": "/component/appmixer/zoho/books/ListOrganizations?outPort=out",
            "data": {
              "transform": "./transformers#organizationsToSelectArray"
            }
          }
        },
        "events": {
          "type": "select",
          "label": "Events",
          "index": 1,
          "defaultValue": "created",
          "tooltip": "Trigger for new invoices only, or also every time an invoice changes: status changes such as sent, paid, overdue or void, and edits.",
          "options": [
            {
              "label": "Created",
              "value": "created"
            },
            {
              "label": "Created or updated",
              "value": "created_or_updated"
            }
          ]
        },
        "status": {
          "type": "select",
          "label": "Status",
          "index": 2,
          "tooltip": "Optionally only trigger for invoices with the selected status.",
          "options": [
            {
              "label": "Draft",
              "value": "Status.Draft"
            },
            {
              "label": "Sent",
              "value": "Status.Sent"
            },
            {
              "label": "Overdue",
              "value": "Status.OverDue"
            },
            {
              "label": "Unpaid",
              "value": "Status.Unpaid"
            },
            {
              "label": "Partially Paid",
              "value": "Status.PartiallyPaid"
            },
            {
              "label": "Paid",
              "value": "Status.Paid"
            },
            {
              "label": "Void",
              "value": "Status.Void"
            }
          ]
        }
      }
    }
  },
  "outPorts": [
    {
      "name": "out",
      "schema": {
        "type": "object",
        "properties": {
          "invoice_id": {
            "type": "string",
            "title": "Invoice ID",
            "example": "460000000038080"
          },
          "invoice_number": {
            "type": "string",
            "title": "Invoice Number",
            "example": "INV-00001"
          },
          "date": {
            "type": "string",
            "title": "Date",
            "example": "2026-06-20"
          },
          "status": {
            "type": "string",
            "title": "Status",
            "example": "sent"
          },
          "total": {
            "type": "number",
            "title": "Total",
            "example": 450
          },
          "balance": {
            "type": "number",
            "title": "Balance",
            "example": 450
          },
          "currency_code": {
            "type": "string",
            "title": "Currency Code",
            "example": "USD"
          },
          "customer_id": {
            "type": "string",
            "title": "Customer ID",
            "example": "460000000026049"
          },
          "customer_name": {
            "type": "string",
            "title": "Customer Name",
            "example": "Bowman Furniture"
          },
          "email": {
            "type": "string",
            "title": "Email",
            "example": "benjamin.geri@bowmanfurniture.com"
          },
          "billing_address": {
            "type": "object",
            "title": "Billing Address",
            "properties": {
              "address": {
                "type": "string",
                "title": "Billing Address.Address",
                "example": "4900 Hopyard Rd"
              },
              "city": {
                "type": "string",
                "title": "Billing Address.City",
                "example": "Pleasanton"
              },
              "state": {
                "type": "string",
                "title": "Billing Address.State",
                "example": "CA"
              },
              "zip": {
                "type": "string",
                "title": "Billing Address.Zip",
                "example": "94588"
              },
              "country": {
                "type": "string",
                "title": "Billing Address.Country",
                "example": "U.S.A"
              }
            }
          },
          "line_items": {
            "type": "array",
            "title": "Line Items",
            "example": [
              {
                "line_item_id": "460000000038092",
                "name": "Hard Drive",
                "description": "500GB, USB 2.0",
                "quantity": 1,
                "rate": 450,
                "item_total": 450
              }
            ],
            "items": {
              "type": "object",
              "properties": {
                "line_item_id": {
                  "type": "string",
                  "title": "Line Item ID",
                  "example": "460000000038092"
                },
                "name": {
                  "type": "string",
                  "title": "Name",
                  "example": "Hard Drive"
                },
                "description": {
                  "type": "string",
                  "title": "Description",
                  "example": "500GB, USB 2.0"
                },
                "quantity": {
                  "type": "number",
                  "title": "Quantity",
                  "example": 1
                },
                "rate": {
                  "type": "number",
                  "title": "Rate",
                  "example": 450
                },
                "item_total": {
                  "type": "number",
                  "title": "Item Total",
                  "example": 450
                }
              }
            }
          },
          "created_time": {
            "type": "string",
            "title": "Created Time",
            "example": "2026-06-20T10:30:00+0000"
          },
          "last_modified_time": {
            "type": "string",
            "title": "Last Modified Time",
            "example": "2026-06-21T08:12:44+0000"
          }
        }
      }
    }
  ],
  "icon": "(data URI omitted)"
}
```
