quotes.send

Lock the quote and get a single-use signing link for the customer (the customer signs on the hosted page; an agent cannot sign or accept a quote). Who may send is shops.sendPermissions: the owner always may, office for any job, a lead for jobs on their crew, and a field worker for jobs assigned to them, until the owner turns that off. Lines an agent drafted are refused until a person who may send quotes sends the quote. An agent token cannot send those lines. A quote imported as history cannot be sent.

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

When to use it

A person whose role may send quotes says to send it. 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. Lock it and send the customer the signing link. An agent token cannot send lines an agent drafted.

What to tell the owner

The quote is locked. Here's the signing link for your customer.

Input

FieldTypeRequired
quote_idstringyes
email_customerbooleanno

Example

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

{
  "quote_id": "00000000-0000-4000-8000-000000000000"
}

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
conflict409The record is in the wrong state for this, for example sending a quote that's already signed. Read it again and pick the next step.
not_found404No such record, or this worker can't see it.
invalid_input, invalid_token, rate_limitedCan happen on any call. See errors.