> ## Documentation Index
> Fetch the complete documentation index at: https://reach-owl.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Notes: Add and Delete Contact Notes

> Add a freeform note to a contact with POST /contacts/{id}/notes. Delete a note with DELETE /notes/{note_id}. Only write actions available for contacts.

Contact notes are the only writeable fields on contacts. You can add freeform text notes to any contact and delete them when no longer needed. Contact names, emails, and other profile data remain read-only.

## Add a Note

Add a new note to a contact.

### Endpoint

```http theme={null}
POST /api/v1/contacts/{contact_id}/notes
```

### Parameters

<ParamField path="contact_id" type="integer" required>
  The unique identifier of the contact.
</ParamField>

<ParamField body="content" type="string" required>
  The text content of the note.
</ParamField>

### Request Example

```bash theme={null}
curl -X POST 'https://reachowl.com/api/v1/contacts/1/notes' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"content": "Followed up on Jan 20"}'
```

### Response Example

```json theme={null}
{
  "id": 2,
  "contact_id": 1,
  "content": "Followed up on Jan 20",
  "created_at": "2024-01-20T14:00:00Z"
}
```

***

## Delete a Note

Remove an existing note by its ID.

### Endpoint

```http theme={null}
DELETE /api/v1/notes/{note_id}
```

### Parameters

<ParamField path="note_id" type="integer" required>
  The unique identifier of the note to delete.
</ParamField>

### Request Example

```bash theme={null}
curl -X DELETE 'https://reachowl.com/api/v1/notes/2' \
  -H 'Authorization: Bearer YOUR_TOKEN'
```

### Response Example

```json theme={null}
{
  "message": "Note deleted successfully"
}
```

## Error Responses

| Status | Description                                     |
| ------ | ----------------------------------------------- |
| 401    | Unauthorized - Invalid or missing Bearer token  |
| 404    | Contact or note not found                       |
| 422    | Validation error - Missing or invalid `content` |