> ## Documentation Index
> Fetch the complete documentation index at: /dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# notes_add

> Add a real note to the person's Library. Asks first.

> [!NOTE]
>
> Free · Your own key only · Asks the person first

Writes a Constella note with a title and content. This changes the person's Library, so it only runs after they say yes. Only add what they asked you to save. To remember something without making a note, use [memory\_add](/dev/docs/api-reference/tools/memory-add.md).

> [!WARNING]
>
> Over HTTP, the first call returns `409 needs_approval`. Ask the person, then send the same call with `"approved": true`. See [Tools that ask first](/dev/docs/concepts/asks-first.md). Refused on a read-only sign-in.

Call it at `POST /platform/v1/me/tools/notes_add`. On MCP, your AI tool calls `notes_add` with the same arguments.

## Arguments

Send these inside `arguments`.

**title** `string` *required*

The note's title.

**content** `string` *required*

The note's text.

## Returns

The tool's answer comes back under `result`.

**success** `boolean`

`true` when the note was saved.

**uniqueid** `string`

The new note's id.

```bash Your key theme={"system"}
curl https://api.constella.app/platform/v1/me/tools/notes_add \
  -H "Authorization: Bearer $CONSTELLA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"approved": true, "arguments": {"title": "Ship day", "content": "We ship on Fridays."}}'
```

```python Python theme={"system"}
import os, requests

r = requests.post(
    "https://api.constella.app/platform/v1/me/tools/notes_add",
    headers={"Authorization": f"Bearer {os.environ['CONSTELLA_API_KEY']}", "X-Constella-Client": "my-script"},
    json={"arguments": {"title": "Ship day", "content": "We ship on Fridays."}, "approved": True},
)
print(r.json()["result"])
```

```javascript JavaScript theme={"system"}
const res = await fetch("https://api.constella.app/platform/v1/me/tools/notes_add", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.CONSTELLA_API_KEY}`,
    "X-Constella-Client": "my-script",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({"arguments": {"title": "Ship day", "content": "We ship on Fridays."}, "approved": true}),
});
const { result } = await res.json();
```

```json 200 theme={"system"}
{
  "result": {
    "success": true,
    "uniqueid": "4b1e..."
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.