---
title: "Add a note to a thread"
description: "Pin a private note to a thread."
url: "https://openemail.uk/docs/api/notes/create"
area: "API"
category: "Mailbox"
---

# Add a note to a thread

Pin a private note to a thread.

`POST /threads/{id}/notes`

## POST /threads/{id}/notes

Pin a private note to a thread.

## Example

Needs `threads:write`. `content` is up to 20,000 characters, `color` is one of `default`, `red`, `orange`, `yellow`, `green`, `blue`, `purple` and `pink`, and `pinned` keeps the note at the top. Answers 201 with the note.

**curl**

```
curl -X POST "$OE/threads/thr_7c1e4a90/notes" -H "$AUTH" -H "Content-Type: application/json" \
  -d '{ "content": "Waiting on the signed contract before replying.", "color": "yellow", "pinned": true }'
```

**Response**

```
{
  "object": "note",
  "id": "b3d1f0c2-7a4e-4f7b-9c1d-2e8f6a5b4c3d",
  "threadId": "thr_7c1e4a90",
  "content": "Waiting on the signed contract before replying.",
  "color": "yellow",
  "pinned": true,
  "order": 4,
  "createdAt": "2026-09-30T09:12:44.000Z",
  "updatedAt": "2026-09-30T09:12:44.000Z"
}
```

> A new note goes after the others. Sending the same request twice adds two notes.

## Reference

- [`POST /threads/{id}/notes`](https://openemail.uk/docs/api/reference/notes#post-threads-id-notes): full reference