> 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).

# Create Estimate

- Component: `appmixer.zoho.books.CreateEstimate`
- Kind: Action
- 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.CreateEstimate>

Create an estimate (quote) for a customer in Zoho Books.

## Input ports

### Port `in`

| Field | Type | Description |
| --- | --- | --- |
| Organization ID (`organizationId`) | text | Select the organization, or enter its ID. When empty, the default organization of the connected account is used. |
| Customer ID (`customerId`) | text | ID of the customer the estimate is for. |
| Line Items (`lineItems`) | textarea | Line items as a JSON array of objects. Use `item_id` to reference an existing item, or set `name`/`description`, `rate` and `quantity` directly. Example: `[{"item_id": "460000000017088", "quantity": 2}, {"description": "Consulting", "rate": 120, "quantity": 1}]`. See the [Zoho Books API docs](https://www.zoho.com/books/api/v3/estimates/#create-an-estimate) for all line item fields. |
| Estimate Number (`estimateNumber`) | text | Number of the estimate. Required only when Ignore Auto Number Generation is on; otherwise Zoho Books numbers the estimate. |
| Reference Number (`referenceNumber`) | text | Your reference for the estimate, e.g. the CRM deal ID. |
| Date (`date`) | date-time | Date of the estimate. Defaults to today. |
| Expiry Date (`expiryDate`) | date-time | Date the estimate expires. |
| Currency ID (`currencyId`) | text | ID of the currency of the estimate. Defaults to the customer's currency. |
| Exchange Rate (`exchangeRate`) | number | Exchange rate of the currency. |
| Discount (`discount`) | text | Discount on the estimate, as a percentage (`12.5%`) or an amount (`190`). |
| Discount Type (`discountType`) | select | Whether the discount applies to the whole estimate or per line item. |
| Discount Before Tax (`isDiscountBeforeTax`) | toggle | Apply the discount before tax is calculated. |
| Rates Include Tax (`isInclusiveTax`) | toggle | Line item rates include tax. |
| Salesperson Name (`salespersonName`) | text | Name of the salesperson. |
| Template ID (`templateId`) | text | ID of the PDF template of the estimate. |
| Notes (`notes`) | textarea | Notes shown on the estimate. |
| Terms (`terms`) | textarea | Terms and conditions shown on the estimate. |
| Shipping Charge (`shippingCharge`) | number | Shipping charge added to the estimate. |
| Adjustment (`adjustment`) | number | Amount added to or subtracted from the total, e.g. for rounding. |
| Adjustment Description (`adjustmentDescription`) | text | Description of the adjustment, e.g. Rounding off. |
| Custom Fields (`customFields`) | textarea | Custom fields as a JSON array. Example: `[{"index": 1, "value": "Q4 campaign"}]`. |
| Ignore Auto Number Generation (`ignoreAutoNumberGeneration`) | toggle | Use the Estimate Number you set instead of the automatic number. |
| Send to Customer (`send`) | toggle | Email the estimate to the customer's contact persons after it is created. |

## Output ports

### Port `out`

| Field | Type | Description |
| --- | --- | --- |
| Estimate ID (`estimate_id`) | string | - |
| Estimate Number (`estimate_number`) | string | - |
| Date (`date`) | string | - |
| Expiry Date (`expiry_date`) | string | - |
| Reference Number (`reference_number`) | string | - |
| Status (`status`) | string | - |
| Customer ID (`customer_id`) | string | - |
| Customer Name (`customer_name`) | string | - |
| Currency Code (`currency_code`) | string | - |
| Sub Total (`sub_total`) | number | - |
| Tax Total (`tax_total`) | number | - |
| Total (`total`) | number | - |
| Line Items (`line_items`) | array | - |
| Notes (`notes`) | string | - |
| Terms (`terms`) | string | - |
| Salesperson Name (`salesperson_name`) | string | - |
| Created Time (`created_time`) | string | - |
| Last Modified Time (`last_modified_time`) | string | - |

## Full metadata (component.json)

```json
{
  "name": "appmixer.zoho.books.CreateEstimate",
  "label": "Create Estimate",
  "author": "Appmixer <info@appmixer.com>",
  "description": "Create an estimate (quote) for a customer in Zoho Books.",
  "version": "1.0.0",
  "auth": {
    "service": "appmixer:zoho:books",
    "scope": [
      "ZohoBooks.estimates.CREATE"
    ]
  },
  "quota": {
    "manager": "appmixer:zoho:books",
    "resources": "requests",
    "scope": {
      "userId": "{{userId}}"
    }
  },
  "inPorts": [
    {
      "name": "in",
      "schema": {
        "type": "object",
        "properties": {
          "organizationId": {
            "type": "string"
          },
          "customerId": {
            "type": "string"
          },
          "lineItems": {
            "type": "string"
          },
          "estimateNumber": {
            "type": "string"
          },
          "referenceNumber": {
            "type": "string"
          },
          "date": {
            "type": "string"
          },
          "expiryDate": {
            "type": "string"
          },
          "currencyId": {
            "type": "string"
          },
          "exchangeRate": {
            "type": "number"
          },
          "discount": {
            "type": "string"
          },
          "discountType": {
            "type": "string"
          },
          "isDiscountBeforeTax": {
            "type": "boolean"
          },
          "isInclusiveTax": {
            "type": "boolean"
          },
          "salespersonName": {
            "type": "string"
          },
          "templateId": {
            "type": "string"
          },
          "notes": {
            "type": "string"
          },
          "terms": {
            "type": "string"
          },
          "shippingCharge": {
            "type": "number"
          },
          "adjustment": {
            "type": "number"
          },
          "adjustmentDescription": {
            "type": "string"
          },
          "customFields": {
            "type": "string"
          },
          "ignoreAutoNumberGeneration": {
            "type": "boolean"
          },
          "send": {
            "type": "boolean"
          }
        },
        "required": [
          "customerId",
          "lineItems"
        ]
      },
      "inspector": {
        "inputs": {
          "organizationId": {
            "type": "text",
            "label": "Organization ID",
            "index": 0,
            "tooltip": "Select the organization, or enter its ID. When empty, the default organization of the connected account is used.",
            "source": {
              "url": "/component/appmixer/zoho/books/ListOrganizations?outPort=out",
              "data": {
                "transform": "./transformers#organizationsToSelectArray"
              }
            }
          },
          "customerId": {
            "type": "text",
            "label": "Customer ID",
            "index": 1,
            "tooltip": "ID of the customer the estimate is for."
          },
          "lineItems": {
            "type": "textarea",
            "label": "Line Items",
            "index": 2,
            "tooltip": "Line items as a JSON array of objects. Use <code>item_id</code> to reference an existing item, or set <code>name</code>/<code>description</code>, <code>rate</code> and <code>quantity</code> directly. Example: <code>[{\"item_id\": \"460000000017088\", \"quantity\": 2}, {\"description\": \"Consulting\", \"rate\": 120, \"quantity\": 1}]</code>. See the <a href=\"https://www.zoho.com/books/api/v3/estimates/#create-an-estimate\" target=\"_blank\">Zoho Books API docs</a> for all line item fields."
          },
          "estimateNumber": {
            "type": "text",
            "label": "Estimate Number",
            "index": 3,
            "tooltip": "Number of the estimate. Required only when Ignore Auto Number Generation is on; otherwise Zoho Books numbers the estimate."
          },
          "referenceNumber": {
            "type": "text",
            "label": "Reference Number",
            "index": 4,
            "tooltip": "Your reference for the estimate, e.g. the CRM deal ID."
          },
          "date": {
            "type": "date-time",
            "label": "Date",
            "index": 5,
            "tooltip": "Date of the estimate. Defaults to today.",
            "config": {
              "format": "YYYY-MM-DD",
              "enableTime": false
            }
          },
          "expiryDate": {
            "type": "date-time",
            "label": "Expiry Date",
            "index": 6,
            "tooltip": "Date the estimate expires.",
            "config": {
              "format": "YYYY-MM-DD",
              "enableTime": false
            }
          },
          "currencyId": {
            "type": "text",
            "label": "Currency ID",
            "index": 7,
            "tooltip": "ID of the currency of the estimate. Defaults to the customer's currency."
          },
          "exchangeRate": {
            "type": "number",
            "label": "Exchange Rate",
            "index": 8,
            "tooltip": "Exchange rate of the currency."
          },
          "discount": {
            "type": "text",
            "label": "Discount",
            "index": 9,
            "tooltip": "Discount on the estimate, as a percentage (<code>12.5%</code>) or an amount (<code>190</code>)."
          },
          "discountType": {
            "type": "select",
            "label": "Discount Type",
            "index": 10,
            "tooltip": "Whether the discount applies to the whole estimate or per line item.",
            "options": [
              {
                "label": "Entity Level",
                "value": "entity_level"
              },
              {
                "label": "Item Level",
                "value": "item_level"
              }
            ]
          },
          "isDiscountBeforeTax": {
            "type": "toggle",
            "label": "Discount Before Tax",
            "index": 11,
            "tooltip": "Apply the discount before tax is calculated."
          },
          "isInclusiveTax": {
            "type": "toggle",
            "label": "Rates Include Tax",
            "index": 12,
            "tooltip": "Line item rates include tax."
          },
          "salespersonName": {
            "type": "text",
            "label": "Salesperson Name",
            "index": 13,
            "tooltip": "Name of the salesperson."
          },
          "templateId": {
            "type": "text",
            "label": "Template ID",
            "index": 14,
            "tooltip": "ID of the PDF template of the estimate."
          },
          "notes": {
            "type": "textarea",
            "label": "Notes",
            "index": 15,
            "tooltip": "Notes shown on the estimate."
          },
          "terms": {
            "type": "textarea",
            "label": "Terms",
            "index": 16,
            "tooltip": "Terms and conditions shown on the estimate."
          },
          "shippingCharge": {
            "type": "number",
            "label": "Shipping Charge",
            "index": 17,
            "tooltip": "Shipping charge added to the estimate."
          },
          "adjustment": {
            "type": "number",
            "label": "Adjustment",
            "index": 18,
            "tooltip": "Amount added to or subtracted from the total, e.g. for rounding."
          },
          "adjustmentDescription": {
            "type": "text",
            "label": "Adjustment Description",
            "index": 19,
            "tooltip": "Description of the adjustment, e.g. Rounding off."
          },
          "customFields": {
            "type": "textarea",
            "label": "Custom Fields",
            "index": 20,
            "tooltip": "Custom fields as a JSON array. Example: <code>[{\"index\": 1, \"value\": \"Q4 campaign\"}]</code>."
          },
          "ignoreAutoNumberGeneration": {
            "type": "toggle",
            "label": "Ignore Auto Number Generation",
            "index": 21,
            "tooltip": "Use the Estimate Number you set instead of the automatic number."
          },
          "send": {
            "type": "toggle",
            "label": "Send to Customer",
            "index": 22,
            "tooltip": "Email the estimate to the customer's contact persons after it is created."
          }
        }
      }
    }
  ],
  "outPorts": [
    {
      "name": "out",
      "schema": {
        "type": "object",
        "properties": {
          "estimate_id": {
            "type": "string",
            "title": "Estimate ID",
            "example": "460000000039131"
          },
          "estimate_number": {
            "type": "string",
            "title": "Estimate Number",
            "example": "EST-00002"
          },
          "date": {
            "type": "string",
            "title": "Date",
            "example": "2026-11-13"
          },
          "expiry_date": {
            "type": "string",
            "title": "Expiry Date",
            "example": "2026-11-30"
          },
          "reference_number": {
            "type": "string",
            "title": "Reference Number",
            "example": "QRT-12346"
          },
          "status": {
            "type": "string",
            "title": "Status",
            "example": "draft"
          },
          "customer_id": {
            "type": "string",
            "title": "Customer ID",
            "example": "460000000026049"
          },
          "customer_name": {
            "type": "string",
            "title": "Customer Name",
            "example": "Bowman Furniture"
          },
          "currency_code": {
            "type": "string",
            "title": "Currency Code",
            "example": "USD"
          },
          "sub_total": {
            "type": "number",
            "title": "Sub Total",
            "example": 120
          },
          "tax_total": {
            "type": "number",
            "title": "Tax Total",
            "example": 0
          },
          "total": {
            "type": "number",
            "title": "Total",
            "example": 120
          },
          "line_items": {
            "type": "array",
            "title": "Line Items",
            "example": [
              {
                "line_item_id": "460000000038092",
                "item_id": "460000000017088",
                "name": "Hard Drive",
                "description": "500GB, USB 2.0",
                "quantity": 1,
                "rate": 120,
                "item_total": 120
              }
            ],
            "items": {
              "type": "object",
              "properties": {
                "line_item_id": {
                  "type": "string",
                  "title": "Line Items.Line Item ID",
                  "example": "460000000038092"
                },
                "item_id": {
                  "type": "string",
                  "title": "Line Items.Item ID",
                  "example": "460000000017088"
                },
                "name": {
                  "type": "string",
                  "title": "Line Items.Name",
                  "example": "Hard Drive"
                },
                "description": {
                  "type": "string",
                  "title": "Line Items.Description",
                  "example": "500GB, USB 2.0"
                },
                "quantity": {
                  "type": "number",
                  "title": "Line Items.Quantity",
                  "example": 1
                },
                "rate": {
                  "type": "number",
                  "title": "Line Items.Rate",
                  "example": 120
                },
                "item_total": {
                  "type": "number",
                  "title": "Line Items.Item Total",
                  "example": 120
                }
              }
            }
          },
          "notes": {
            "type": "string",
            "title": "Notes",
            "example": "Looking forward for your business."
          },
          "terms": {
            "type": "string",
            "title": "Terms",
            "example": "Terms & Conditions apply"
          },
          "salesperson_name": {
            "type": "string",
            "title": "Salesperson Name",
            "example": "Will Smith"
          },
          "created_time": {
            "type": "string",
            "title": "Created Time",
            "example": "2026-11-13T10:30:00+0000"
          },
          "last_modified_time": {
            "type": "string",
            "title": "Last Modified Time",
            "example": "2026-11-13T10:30:00+0000"
          }
        }
      }
    }
  ],
  "icon": "(data URI omitted)"
}
```
