---
title: "Publish Event"
method: POST
path: "/events/publish"
---

# Publish Event

`POST /events/publish`

Generic event publishing endpoint for all entity types.

Creates an event with source='user' to track user-driven actions.
Publishes via the centralized EventPublisher.

## Query parameters

- `user_id` string
- `org_id` string

## Request body

- EventPublishRequest — Request model for single event publishing
  - `entity_type` string, required — The type of entity (e.g., 'client', 'payment', 'expense')
  - `entity_id` string, required — The ID of the entity
  - `event_type` string, required — The type of event to create
  - `event_message` string, required — The event message
  - `metadata` object — Optional event metadata (can include turn_id if needed)
  - `invoice_id` string, nullable — Optional invoice ID to link this event to an invoice
  - `change_type` string, nullable — Type of change (create, update, delete)
  - `thread_id` string, nullable — Thread ID for agent chat context

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/every/apis/every-api.md) · [All operations](https://skmtc.net/every/apis/every-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/every/every-api/versions/9744001af85d/schema)