invoices.markPaidOutside
Record that the customer paid an invoice outside Doing Work (check, cash, financing, insurance or other). Owner or office, or their agent. Closes the invoice, and the job too unless its checklists still block done (job_status says which; finish them and call jobs.complete). The job record says "Paid outside Doing Work", is never marked paid or verified, and no Doing Work receipt goes to the customer. There is no limit on jobs paid outside Doing Work and no fee on them. Agents can record these too unless the owner turned that off with shops.setAgentMoney.
| Who | Agents can call this |
| REST | POST /v1/invoices/paid-outside |
| MCP tool | invoices_markPaidOutside |
| Writes | yes, send an Idempotency-Key |
| Area | Invoices and payments (unlimited) |
When to use it
Record a cash, check, financing or insurance payment the worker tells you about. Refused if the owner turned off agent outside payments.
What to tell the owner
I recorded that payment. Jobs paid outside Doing Work don't get the verified mark. Pay as you go includes 3 a month; paid plans have no limit.
Input
| Field | Type | Required |
|---|---|---|
invoice_id | string | yes |
method | string (one of check, cash, financing, insurance, other) | yes |
paid_on | string | yes |
note | string | no |
Example
POST https://doingwork.work/v1/invoices/paid-outside
content-type: application/json
Idempotency-Key: 3f1c...
{
"invoice_id": "00000000-0000-4000-8000-000000000000",
"method": "check",
"paid_on": "2026-10-31"
}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 |
|---|---|---|
outside_pay_limit | ||
forbidden | 403 | This worker's role can't do this, or it needs a person's own sign-in rather than an agent token. Tell the person who can. |
invalid_input, invalid_token, rate_limited | Can happen on any call. See errors. |