# Create a user note

`POST https://api.cademi.com.br/api/v3/users/{user_id}/notes`

Operation ID: `users.notes.create` · API v3

Adds an internal note about the user. The note is attributed to the credential that created it, and only that credential can later edit or delete it.

Required permissions: `users.update`.

## Parameters

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

## Request body

Content type: `application/json`, required.

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

## Responses

### 201

Returns the newly created note.

Body: `data`: UserNote.

Fields of UserNote:

| Field | Type | Required | Description |
|---|---|---|---|
| `author` | object | yes |  |
| `body` | string | yes |  |
| `created_at` | string (date-time) | yes |  |
| `id` | string | yes |  |
| `object` | string, one of `user_note` | yes |  |
| `updated_at` | string or null (date-time) | no |  |

### 401

The credential is missing, malformed, expired, or revoked.

Body: Error.

### 403

The current credentials do not have the permission required by this operation.

Body: Error.

### 404

The user was not found or is not accessible with the current credentials.

Body: Error.

### 422

The request body or query parameters failed validation.

Body: ValidationFailed.

Full schema: https://cademi.dev/openapi/v3.json