---
title: "Send Draft Event Route"
method: POST
path: "/api/crm/events/{event_id}/send"
tags: ["CRM"]
---

# Send Draft Event Route

`POST /api/crm/events/{event_id}/send`

## 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/events/{event_id}/send`
- Auth: HTTP bearer

Send a previously-drafted event via SendGrid.

Phase 5 surface for the bulk re-engage flow: each generated draft
is a ``DBKolCommunicationEvent`` row (kind='note', direction='outbound',
subject + body_text populated). The UI's per-row Send button POSTs
here with the recipient address; we resolve the draft → look up its
conversation → delegate to ``send_outbound_email`` (same path
Phase 3 uses from ``/conversations/{id}/send``).

We DO NOT mutate the original draft event — the existing send
path stamps a new ``email_sent`` event, which is the audit-clean
behaviour. The drafted note row stays on the timeline so the user
can see "we composed X, sent Y".

## Path parameters

- `event_id` string, required

## Headers

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

## Request body

- SendEmailRequest
  - `to_addr` string, required
  - `subject` string, required
  - `body_text` string, required
  - `body_html` string, nullable

## 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)