---
title: "Create Events"
method: POST
path: "/api/events"
tags: ["Events"]
---

# Create Events

`POST /api/events`

Record a batch of Events

## Headers

- `x-prefect-api-version` string

## Request body

- Event[]
  - `occurred` string, date-time, required — When the event happened from the sender's perspective
  - `event` string, required — The name of the event that happened
  - `resource` Resource, required — An observable business object of interest to the user
  - `related` RelatedResource[] — A list of additional Resources involved in this event
  - `payload` object — An open-ended set of data describing what happened
  - `id` string, uuid, required — The client-provided identifier of this event
  - `follows` string, uuid — The ID of an event that is known to have occurred prior to this one. If set, this may be used to establish a more precise ordering of causally-related events when they occur close enough together in time that the system may receive them out-of-order.

## Response `204`

Successful Response

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/prefecthq/apis/untitled-api-2.md) · [All operations](https://skmtc.net/prefecthq/apis/untitled-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/prefecthq/untitled-api-2/revisions/29ba6c4f8837/schema)