# Create note

Add an internal note to an event.

Source: https://statusdashboard.com/docs/api/event-management/events/notes/create

`POST /app/events/{id}/notes`

Adds a new internal note to the event. Notes are **never visible** on published status dashboards.

***

## Path parameters
| Parameter | Description   |
| --------- | ------------- |
| `id`      | The event ID. |

***

## Request
See [API Basics](/docs/api) for required headers.

### Request body
| Field  | Type   | Required | Description                      |
| ------ | ------ | -------- | -------------------------------- |
| `note` | string | Yes      | Note text. Max 5,000 characters. |

***

## Sample request
```bash
curl -X POST https://api.statusdashboard.com/app/events/4f8b2e1a-3c7d-4e9f-a0b1-c2d3e4f56789/notes \
  -H "Authorization: Bearer bcf847abf5c6:def456" \
  -H "Content-Type: application/json" \
  -d '{
    "note": "Escalated to database team at 10:15 UTC. Pager duty alert sent."
  }'
```

## Sample response
**Status: `201 Created`**

```json
{
  "note": {
    "noteId": "2e8c5b9a-4d7f-4a0b-b2d4-e5f6789abcde",
    "timestamp": "2026-04-25T10:15:00.000Z",
    "note": "Escalated to database team at 10:15 UTC. Pager duty alert sent.",
    "author": "user@example.com",
    "isEdited": false
  }
}
```

Response fields match [List notes — Note fields](/docs/api/event-management/events/notes/list#note-fields).

***

## Error responses
| Status | When                                              |
| ------ | ------------------------------------------------- |
| `400`  | Validation error — note text missing or too long. |
| `403`  | Insufficient permissions.                         |
| `404`  | Event not found.                                  |