---
title: "Create Event"
method: POST
path: "/api/v1/events"
---

# Create Event

`POST /api/v1/events`

Create an [event](https://app.voker.ai/docs/concepts/events#events).

Creating an endpoint requires supplying a fingerprint. See how to create a fingerprint [here](https://app.voker.ai/docs/concepts/events#creating-a-fingerprint).

Agents, Agent Versions, People and Sessions that are provided but do not exist will be created.

## Headers

- `Authorization` string, required

## Request body

- CreateEventPayload — Create an event. See [Creating an Event](https://app.voker.ai/docs/concepts/events#creating-an-event-via-sdk) for more information.
  - `event_name` 'llm', required — Type of the event. Currently, only "llm" is supported.
  - `properties` EventProperties, required — LLM event properties. Inputs includes the body of the llm call and output includes the response from the llm call in the provider specific format.
    - `api` 'openai-chat-completions' | 'openai-responses' | 'gemini-models' | 'gemini-interactions' | 'anthropic-messages' | 'anthropic-beta-messages' | 'aisdk', required
    - `inputs` object, required
    - `output` object, required
  - `fingerprint_id` string, uuid, required — The [fingerprint](https://app.voker.ai/docs/concepts/events#fingerprints) of the client that generated the event.
  - `agent` string, nullable — The name of the [agent](https://app.voker.ai/docs/concepts/agents#agents) associated with the event. If this agent does not exist, it will be created.
  - `agent_version` string, nullable — The name of the [agent version](https://app.voker.ai/docs/concepts/agents#agent-versions) associated with the event. If this agent version does not exist, it will be created. If an agent version is not supplied, a default version will be used.
  - `person` string, nullable — The unique identifier of the [person](https://app.voker.ai/docs/concepts/people) associated with the event. If the person does not exist, it will be created.
  - `session` string, required — The unique identifier of the [session](https://app.voker.ai/docs/concepts/events#event-sessions) associated with the event.

## Response `200`

Successful Response

- unknown

## Other responses

- `404` — Not Found
- `422` — Unprocessable Content

---

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