# Add a note to a lead

`POST https://app.whatsetter.com/api/v1/leads/{id}/notes`

Writes a `note` entry in the lead's journal, shown in the dashboard's
timeline with `API · <key name>` as its author. 1 to 2000 characters.
Requires scope `leads:write`.

## Parameters

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `id` | path | string | yes |  |

## Request body

| Field | Type | Required | Description |
|---|---|---|---|
| `text` | string | yes |  |

```json
{
  "text": "Wants a call after the 25th, budget confirmed."
}
```

## Example request

```bash
curl --request POST \
  --url 'https://app.whatsetter.com/api/v1/leads/{id}/notes' \
  --header 'Authorization: Bearer ws_live_…'
  --header 'Content-Type: application/json' \
  --data '{"text":"Wants a call after the 25th, budget confirmed."}'
```

## Responses

### 201: The note

```json
{
  "data": {
    "id": "68ed11aa22bb33cc44dd55ee",
    "text": "Wants a call after the 25th, budget confirmed.",
    "author": "API · HubSpot sync",
    "created_at": "2026-09-19T08:14:02.000Z"
  }
}
```

### 401: Missing, unknown or revoked API key

```json
{
  "error": {
    "code": "",
    "message": ""
  }
}
```

### 404: Resource not found in this workspace

```json
{
  "error": {
    "code": "",
    "message": ""
  }
}
```

### 422: Empty or too long

```json
{
  "error": {
    "code": "validation_error",
    "message": "\"text\" is required (1 to 2000 characters)."
  }
}
```


Source: https://docs.whatsetter.com/api-reference/operations/createleadnote/
