--- title: quotes.sign | Doing Work API description: Sign a quote after accepting electronic signing and typing a name. Hosted page only. The link is enough. The signer recorded is the job customer's email and. url: https://doingwork.work/docs/reference/quotes-sign/ --- # quotes.sign Sign a quote after accepting electronic signing and typing a name. Hosted page only. The link is enough. The signer recorded is the job customer's email and the typed name, never whoever is signed in on the browser. | | | |---|---| | Who | Hosted page only (a person does it in the browser) | | REST | `POST /v1/quotes/sign` | | MCP tool | Not an MCP tool | | Writes | yes, send an Idempotency-Key | | Area | [Quotes (unlimited)](https://doingwork.work/docs/reference/#quotes-unlimited) | ## When to use it Never call it. The customer opens the link from the email or text and types signer_name. They do not need a Doing Work account, and a signed-in browser session is not the signer. n is the hidden value printed on the quote page and bound to this link. ## What to tell the owner Your customer signs on their phone. In Idaho, quotes over $2,000 show the state disclosure and they acknowledge it. ## Input | Field | Type | Required | |---|---|---| | `t` | string | yes | | `n` | string | no | | `document_hash` | string (sha256) | yes | | `esign_consent` | string (one of yes) | yes | | `disclosure_ack` | string (one of yes) | no | | `signer_name` | string | yes | | `option` | string | no | | `optional_lines` | string | no | ## Example ```http POST https://doingwork.work/v1/quotes/sign content-type: application/json Idempotency-Key: 3f1c... { "t": "...", "document_hash": "...", "esign_consent": "yes", "signer_name": "..." } ``` ## 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 | |---|---|---| | `human_only` | 403 | This step happens on a hosted page the person opens themselves. Send them the link; don't try another route. | | `consent_required` | 400 | A person must tick a consent box on a hosted page (for example e-sign). Send them the link. | | `disclosure_ack_required` | 400 | The customer must acknowledge the Idaho disclosure on the hosted signing page. | | `invalid_link` | 400 | The link was used, expired, or replaced by a newer one. Get a new link. | | `invalid_input`, `invalid_token`, `rate_limited` | | Can happen on any call. See [errors](https://doingwork.work/docs/errors/). |