--- title: quotes.create | Doing Work API description: Create a quote (AI can draft lines; a person who can send quotes approves agent-drafted lines before the quote is sent). url: https://doingwork.work/docs/reference/quotes-create/ --- # 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. | | | |---|---| | Who | Agents can call this | | REST | `POST /v1/quotes` | | MCP tool | `quotes_create` | | Writes | yes, send an Idempotency-Key | | Area | [Quotes (unlimited)](https://doingwork.work/docs/reference/#quotes-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 | Field | Type | Required | |---|---|---| | `job_id` | string | yes | | `lines` | array | yes | | `lines[].description` | string | yes | | `lines[].quantity` | number | yes | | `lines[].unit_price_minor` | integer | yes | | `lines[].option_key` | string | no | | `lines[].optional` | boolean | no | | `lines[].kind` | string (one of item, fee, discount) | no | | `lines[].taxable` | boolean | no | | `options` | array | no | | `options[].key` | string | yes | | `options[].label` | string | yes | | `tm` | object | no | | `tm.rate_unit` | string (one of hour, day) | yes | | `tm.rate_minor` | integer | yes | | `tm.rush_rate_minor` | integer | no | | `tm.hours_per_day` | number | no | | `tm.materials_markup_bps` | integer | no | | `tm.cap_minor` | integer | no | | `notes` | ['string', 'null'] | no | | `tax_rate_id` | ['string', 'null', ' ', '(', 'u', 'u', 'i', 'd', ')'] | no | ## Example ```http 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 | Code | Status | What to do | |---|---|---| | `invalid_input` | 400 | A field is missing, the wrong type, or unknown. The message names the field. Fix the input; don't retry as is. | | `not_found` | 404 | No such record, or this worker can't see it. | | `invalid_input`, `invalid_token`, `rate_limited` | | Can happen on any call. See [errors](https://doingwork.work/docs/errors/). |