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

# Create Event

`POST /api/v1/events`

## Request

- Base URL: `https://evals.voker.ai/api/v1`
- URL: `https://evals.voker.ai/api/v1/api/v1/events`
- Auth: none required

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.dev/voker/apis/voker-api.md) - [All operations](https://skmtc.dev/voker/apis/voker-api/llms.txt) - [OpenAPI document](https://skmtc.dev/voker/apis/voker-api/revisions/d237dc301251?raw)