---
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.
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/). |