---
title: "Add Event Route"
method: POST
path: "/api/crm/conversations/{conversation_id}/events"
tags: ["CRM"]
---

# Add Event Route

`POST /api/crm/conversations/{conversation_id}/events`

## Request

- Base URL: `https://api.kolens.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.kolens.ai/api/crm/conversations/{conversation_id}/events`
- Auth: HTTP bearer

## Path parameters

- `conversation_id` string, required

## Headers

- `x-kolens-user-id` string, nullable
- `x-kolens-workspace-id` string, nullable

## Request body

- AddEventRequest
  - `kind` 'note' | 'call_log', required
  - `direction` 'outbound' | 'inbound' | 'internal'
  - `body` string

## Response `201`

Successful Response

- EventOut
  - `id` string, required
  - `conversation_id` string, required
  - `kind` string, required
  - `direction` string, required
  - `body` string, required
  - `sent_by_user_id` string, nullable
  - `sent_at` string, date-time, required
  - `ai_generated` boolean, required
  - `sender_email` string, nullable
  - `subject` string, nullable
  - `body_text` string, nullable
  - `body_html` string, nullable
  - `received_at` string, date-time, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/kolens/apis/kolens-api.md) · [All operations](https://skmtc.dev/kolens/apis/kolens-api/llms.txt) · [OpenAPI document](https://skmtc.dev/kolens/apis/kolens-api/revisions/5d6865ab0a24?raw)
