# Create an entity narrative

**POST** `/entities/{entity_id}/narratives`

Append a free-form note to an entity's customer file, such as the context a reviewer records while collecting CIP/CDD documentation. Narratives are append-only: they cannot be edited after creation, only deleted as individual records.

### Path Parameters

- `entity_id` `string` _(required)_ — Unique identifier for the entity.

### Body Parameters

- `body` `string` _(required)_ — The free-form text of the narrative. Maximum length is 30,000 characters. Narratives are append-only and cannot be edited after creation.
- `related_document_id` `string` — Optional ID of a document this narrative references. The document must belong to your platform.
- `related_field` `string` — Optional entity field path this narrative is about, e.g. `last_name` or `associated_persons.control_person.address`.

**Request**

```shell
curl 'https://api.column.com/entities/<entity_id>/narratives' \
  -XPOST \
  -u :<YOUR API KEY> \
  -H 'Content-Type: application/json' \
  -d '{
  "body": "example_body",
  "related_document_id": "<related_document_id>",
  "related_field": "CHASUS33XXX"
}'
```

**Response 200**

```json
{
  "body": "example_body",
  "created_at": "2024-01-15T09:30:00Z",
  "entity_id": "enti_2Q1ctiJm1NypVqCt8UBC8e4xTfH",
  "id": "item_2Q1ctiJm1NypVqCt8UBC8e4xTfH",
  "related_document_id": "redo_2Q1ctiJm1NypVqCt8UBC8e4xTfH",
  "related_field": "CHASUS33XXX"
}
```
