---
title: "Adds a Quote"
method: POST
path: "/Quotation"
tags: ["Quotes"]
---

# Adds a Quote

`POST /Quotation`

## Request

- Base URL: `https://api.insightly.com/v3.1`
- URL: `https://api.insightly.com/v3.1/Quotation`
- Auth: none declared. Required headers: `Authorization`

If you have trouble with creating a Quote, try creating Quotes via the web interface, and then access those Quotes via the API. This way you            can see examples of the fields and sub-elements attached to the Quote. A common source of problems during write/update request is caused when users omit            required fields, or insert invalid data in a field (e.g. reference a CATEGORY_ID that does not exist in the user's Insightly instance.

## Headers

- `Authorization` string, required

## Request body

- object
  - `QUOTE_ID` integer
  - `QUOTATION_NAME` string, string, required
  - `OPPORTUNITY_ID` integer, required
  - `CONTACT_ID` integer
  - `ORGANISATION_ID` integer
  - `PRICEBOOK_ID` integer
  - `QUOTATION_DESCRIPTION` string, string
  - `QUOTATION_PHONE` string, string
  - `QUOTATION_EMAIL` string, string
  - `QUOTATION_FAX` string, string
  - `QUOTE_STATUS` string, string
  - `QUOTATION_EXPIRATION_DATE` string, date-time
  - `IS_SYNCING` boolean
  - `SHIPPING_HANDLING` number
  - `TAX` number
  - `ADDRESS_BILLING_NAME` string, string
  - `ADDRESS_BILLING_STREET` string, string
  - `ADDRESS_BILLING_CITY` string, string
  - `ADDRESS_BILLING_STATE` string, string
  - `ADDRESS_BILLING_POSTCODE` string, string
  - `ADDRESS_BILLING_COUNTRY` string, string
  - `ADDRESS_SHIPPING_NAME` string, string
  - `ADDRESS_SHIPPING_STREET` string, string
  - `ADDRESS_SHIPPING_CITY` string, string
  - `ADDRESS_SHIPPING_STATE` string, string
  - `ADDRESS_SHIPPING_POSTCODE` string, string
  - `ADDRESS_SHIPPING_COUNTRY` string, string
  - `CUSTOMFIELDS` APICustomField[]
    - `FIELD_NAME` string
    - `FIELD_VALUE` object

## Response `201`

Request succeeded.

- object
  - `QUOTE_ID` integer
  - `QUOTATION_NAME` string, string, required
  - `OPPORTUNITY_ID` integer, required
  - `CONTACT_ID` integer
  - `ORGANISATION_ID` integer
  - `PRICEBOOK_ID` integer
  - `QUOTATION_NUMBER` string, string
  - `QUOTATION_DESCRIPTION` string, string
  - `QUOTATION_PHONE` string, string
  - `QUOTATION_EMAIL` string, string
  - `QUOTATION_FAX` string, string
  - `QUOTE_STATUS` string, string
  - `QUOTATION_EXPIRATION_DATE` string, date-time
  - `LINE_ITEM_COUNT` integer
  - `IS_SYNCING` boolean
  - `QUOTATION_CURRENCY_CODE` string, string
  - `SUBTOTAL` number
  - `DISCOUNT` number
  - `TOTAL_PRICE` number
  - `SHIPPING_HANDLING` number
  - `TAX` number
  - `GRAND_TOTAL` number
  - `ADDRESS_BILLING_NAME` string, string
  - `ADDRESS_BILLING_STREET` string, string
  - `ADDRESS_BILLING_CITY` string, string
  - `ADDRESS_BILLING_STATE` string, string
  - `ADDRESS_BILLING_POSTCODE` string, string
  - `ADDRESS_BILLING_COUNTRY` string, string
  - `ADDRESS_SHIPPING_NAME` string, string
  - `ADDRESS_SHIPPING_STREET` string, string
  - `ADDRESS_SHIPPING_CITY` string, string
  - `ADDRESS_SHIPPING_STATE` string, string
  - `ADDRESS_SHIPPING_POSTCODE` string, string
  - `ADDRESS_SHIPPING_COUNTRY` string, string
  - `OWNER_USER_ID` integer
  - `DATE_CREATED_UTC` string, date-time
  - `DATE_UPDATED_UTC` string, date-time
  - `CREATED_USER_ID` integer
  - `CUSTOMFIELDS` APICustomField[]
    - `FIELD_NAME` string
    - `FIELD_VALUE` object

## Other responses

- `400`: Data validation error.
- `401`: Authentication failed.
- `402`: Record limit reached.

---

[API](https://skmtc.dev/insightly/apis/insightly-api-v3-1.md) - [All operations](https://skmtc.dev/insightly/apis/insightly-api-v3-1/llms.txt) - [OpenAPI document](https://skmtc.dev/insightly/apis/insightly-api-v3-1/revisions/e7df0c3b65fb?raw)