Create Quote

Creates a new draft quote from a template. Sections and line items
are added via their own endpoints after creation.

The contact is identified by email plus either client_id or
client_name; when both are provided, client_id is used. A contact
that does not exist is created; with client_name that requires
first_name and last_name.

Contact details (contact.first_name and its siblings) and
billing_address are recorded on this quote and saved to the contact,
so the contact keeps the latest values; other quotes keep the details
they were created with. Omitted details carry the contact's current
values forward. Supplying any of them requires a billing address country,
either in this request or on the contact.

Response body matches GET /v1/quotes/{quote_id}.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

Request payload for creating a new draft quote from a template.

string | null

Internal sales notes attached to the quote. Plain text.

billing_address
object | null

Billing address recorded on this quote and saved to the contact.
Omitted fields carry the contact's current values forward. Supply
country_code whenever the contact has no address yet.

contact
object
required

Primary billing contact reference on the new quote, with the details to record against it.

content_blocks
object | null

Quote-level content blocks, grouped by section. Section comes
from the key, order from the array index. Blocks are resolved
against the account's content-block library by name: a known
name reuses the library block and pins a new version whenever
the body differs, an unseen name creates a new library block.
Blocks are never inherited from template_id. At most 50
entries across both sections.

cover_page
object | null

The Quote's cover page, in the same shape the Quote returns. When
cover_page is omitted or null, or a field inside it is
omitted, the Quote Template's value applies.

string | null
deprecated

Deprecated. Accepted until 2027-11-30. Use
cover_page.content instead. Sending cover_page together with a non-empty
cover_page_* field returns 422.

HTML body for the quote cover page.

string | null
deprecated

Deprecated. Accepted until 2027-11-30. Use
cover_page.subtitle instead. Sending cover_page together with a non-empty
cover_page_* field returns 422.

Cover page subtitle. Max 125 characters.

string | null
deprecated

Deprecated. Accepted until 2027-11-30. Use
cover_page.title instead. Sending cover_page together with a non-empty
cover_page_* field returns 422.

Cover page title. Max 100 characters.

string | null

ISO 4217 currency code (3 letters). Must be enabled on the
account. When omitted, the account's default currency applies.

string | null

Caller-supplied quote number override. Max 250 characters.
Leave null to let the system assign number at publish.

date-time | null

Quote expiration date, as an RFC 3339 UTC timestamp with second
precision. Must not be in the past. When null, the account's
default expiration window applies at publish time.

string | null

Initiative the quote belongs to. Max 50 characters.

string | null

Private notes on the quote, not shown to the contact.

string | null

Quote display name. Max 75 characters.

owner
object | null

Assigns the quote to a specific user by email. When omitted or
set to null, the quote defaults to the authenticated user
resolved from the API key. The referenced user must belong to
the same account or the request fails with
ERR_OWNER_EMAIL_NOT_FOUND.

tax_codes
array of objects | null

Quote-level tax codes to apply. Each entry carries the label and rate inline.

tax_codes
string
required

Quote template public ID to seed content from.

Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json