---
title: "Emit a project event"
method: POST
path: "/events"
tags: ["Events"]
---

# Emit a project event

`POST /events`

Stores one timestamped project event. Event names must be lowercase and
may contain optional dot-separated segments; each segment starts with a
lowercase letter and may contain lowercase letters, numbers, and
underscores. `conversation_id` is optional; include it when the
event belongs to a WhatsApp conversation.

## Request body

- ProjectEventCreateRequest
  - `name` string, required — Event name. Must be lowercase and may contain optional dot-separated segments. Each segment starts with a lowercase letter and may contain lowercase letters, numbers, and underscores. Maximum 128 characters.
  - `occurred_at` string, date-time — Optional event timestamp. Defaults to the current time.
  - `conversation_id` string, uuid — Optional WhatsApp conversation ID to link to the event
  - `properties` object — Optional flat event properties object

## Response `201`

Event created

- ProjectEventResponse
  - `data` ProjectEvent, required
    - `id` string, uuid, required — Unique event ID
    - `name` string, required — Event name. Must be lowercase and may contain optional dot-separated segments. Maximum 128 characters.
    - `occurred_at` string, date-time, required — When the event occurred
    - `conversation_id` string, uuid, nullable, required — Linked WhatsApp conversation ID, when provided
    - `properties` object, required — Flat event properties object

## Other responses

- `401` — Missing or invalid API key
- `402` — Feature requires a paid plan
- `422` — Request validation failed

---

[API](https://skmtc.net/kapso/apis/kapso-platform-api.md) · [All operations](https://skmtc.net/kapso/apis/kapso-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kapso/kapso-platform-api/revisions/18ff5548a33f/schema)