Create a new quote

POSThttps://app.speybooks.com/api/v1/quotes/

Create a new quote, in draft status by default (status may be set to sent to create and issue in one call). Requires at least one line item.

Line quantity and unitPrice are exact decimal strings and must be strictly positive; unitPrice is in pounds. vatRate is an integer percent. The quote number is auto-generated from the organisation's quote numbering sequence, and totals are computed server-side with exact decimal arithmetic.

Contact ID and optional per-line account IDs are validated and resolved from their prefixed API format.

Body parameters

contactIdstringrequired
Contact ID (e.g. cont_3).
issueDatestringrequired
Quote issue date (YYYY-MM-DD).
linesarray<object>required
Show child parameters
descriptionstringrequired
Line item description.
quantitystringrequired
Quantity as exact decimal string.
unitPricestringrequired
Unit price as exact decimal pounds string.
vatRateintegerrequired
VAT rate as integer percent.
min: 0 · max: 100
accountIdstringoptional
Chart of accounts ID to post to (e.g. acc_4010).
validUntilstringrequired
Quote expiry date (YYYY-MM-DD).
notesstringoptional
Optional notes visible on the quote.
referencestringoptional
Optional client-facing reference.

Response

201Quote created in draft status with auto-generated quote number.
Show response fields
idstring
quoteNumberstring