quotes.create

Create a quote (AI can draft lines; a person who can send quotes approves agent-drafted lines before the quote is sent). Optional: good, better, best options and optional lines the customer picks when signing.

WhoAgents can call this
RESTPOST /v1/quotes
MCP toolquotes_create
Writesyes, send an Idempotency-Key
AreaQuotes (unlimited)

When to use it

An agent you connect can draft the lines and prices from what the shop tells you or its price book. A person whose role may send quotes sends lines an agent drafted. The owner can always send. Office can send for any job, a lead for jobs on their crew, and field for jobs assigned to them, until the owner turns send_quotes off. An agent token cannot send those lines.

What to tell the owner

I drafted the quote lines and prices. A person whose role may send quotes has to send it. I cannot send lines I drafted.

Input

FieldTypeRequired
job_idstringyes
linesarrayyes
lines[].descriptionstringyes
lines[].quantitynumberyes
lines[].unit_price_minorintegeryes
lines[].option_keystringno
lines[].optionalbooleanno
lines[].kindstring (one of item, fee, discount)no
lines[].taxablebooleanno
optionsarrayno
options[].keystringyes
options[].labelstringyes
tmobjectno
tm.rate_unitstring (one of hour, day)yes
tm.rate_minorintegeryes
tm.rush_rate_minorintegerno
tm.hours_per_daynumberno
tm.materials_markup_bpsintegerno
tm.cap_minorintegerno
notes['string', 'null']no
tax_rate_id['string', 'null', ' ', '(', 'u', 'u', 'i', 'd', ')']no

Example

POST https://doingwork.work/v1/quotes
content-type: application/json
Idempotency-Key: 3f1c...

{
  "job_id": "00000000-0000-4000-8000-000000000000",
  "lines": [
    {
      "description": "40 gallon gas heater, installed",
      "quantity": "...",
      "unit_price_minor": 50000
    }
  ]
}

Output

JSON. The response shape isn't published yet; read the fields you need and ignore the rest. Errors are {code, message, status}.

Errors

CodeStatusWhat to do
invalid_input400A field is missing, the wrong type, or unknown. The message names the field. Fix the input; don't retry as is.
not_found404No such record, or this worker can't see it.
invalid_input, invalid_token, rate_limitedCan happen on any call. See errors.