--- title: invoices.send | Doing Work API description: Send an invoice (or the next part of it) and get a single-use pay link. Who may send is shops.sendPermissions: the owner always may, office for any job, a. url: https://doingwork.work/docs/reference/invoices-send/ --- # invoices.send Send an invoice (or the next part of it) and get a single-use pay link. 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 stay unsent until a person who may send invoices sends them. An agent token cannot send those lines. Earlier pay links stop working. Refused with conflict on a Doing Work deposit invoice whose booking ended (shop cancel or no-show). payments_ready false means the shop has no active payments account yet (after a hand-off, connect one with payments.connectLink); the link shows payment isn't available until it does. | | | |---|---| | Who | Agents can call this | | REST | `POST /v1/invoices/send` | | MCP tool | `invoices_send` | | Writes | yes, send an Idempotency-Key | | Area | [Invoices and payments (unlimited)](https://doingwork.work/docs/reference/#invoices-and-payments-unlimited) | ## When to use it Send the invoice, or the next part of it, and get a pay link for the customer. ## What to tell the owner Here's the pay link for your customer. The money goes to your Stripe account. ## Input | Field | Type | Required | |---|---|---| | `invoice_id` | string | yes | | `amount_minor` | integer | no | | `percent` | number | no | | `email_customer` | boolean | no | ## Example ```http POST https://doingwork.work/v1/invoices/send content-type: application/json Idempotency-Key: 3f1c... { "invoice_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 | Code | Status | What to do | |---|---|---| | `payments_not_set_up` | 409 | The shop hasn't connected Stripe. The owner does that on a hosted page. | | `conflict` | 409 | The 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. | | `feature_unavailable` | 403 | This isn't available for this shop or place yet. | | `invalid_input`, `invalid_token`, `rate_limited` | | Can happen on any call. See [errors](https://doingwork.work/docs/errors/). |