--- title: subs.addNote | Doing Work API description: Leave a note for the shop on this job, as the subcontractor (up to 20 a day). Hosted page only. Doing Work REST, MCP, and A2A field service operation. url: https://doingwork.work/docs/reference/subs-addnote/ --- # subs.addNote Leave a note for the shop on this job, as the subcontractor (up to 20 a day). Hosted page only. | | | |---|---| | Who | Hosted page only (a person does it in the browser) | | REST | `POST /v1/subs/addNote` | | MCP tool | Not an MCP tool | | Writes | yes, send an Idempotency-Key | | Area | [Field work (checklists, forms, time, notes, change orders, subcontractors)](https://doingwork.work/docs/reference/#field-work-checklists-forms-time-notes-change-orders-subcontractors) | ## When to use it Leave a note for the shop on this job, as the subcontractor (up to 20 a day). Hosted page only. ## What to tell the owner Send the person the link. They finish this step themselves on the page; you never do it for them. ## Input | Field | Type | Required | |---|---|---| | `k` | string | yes | | `body` | string | yes | ## Example ```http POST https://doingwork.work/v1/subs/addNote content-type: application/json Idempotency-Key: 3f1c... { "k": "...", "body": "..." } ``` ## Output | Field | Type | Always there | |---|---|---| | `note_id` | string (uuid) | yes | ```json { "note_id": "00000000-0000-4000-8000-000000000000" } ``` ## Errors | Code | Status | What to do | |---|---|---| | `invalid_input`, `invalid_token`, `rate_limited` | | Can happen on any call. See [errors](https://doingwork.work/docs/errors/). |