---
title: "POST /api/v1/data/events"
method: POST
path: "/api/v1/data/events"
tags: ["DataV1"]
---

# POST /api/v1/data/events

`POST /api/v1/data/events`

## Request body

- Datav1CreateEventRequest
  - `event` Datav1Event
    - `category` string — Change Event categories are case sensitive. Each of the listed categories are lowercase and must be queried in all lowercase. For example, `"category": "alerts"` is valid, but `"category": "Alerts"` is invalid. Chronosphere Support can add and remove custom categories upon request. Because categories are case sensitive, custom categories must be queried using the same case they were created. For example, if you create a category called `INGEST`, any queries in Changes Explorer must use `INGEST` in all uppercase as the category to query.
    - `happened_at` string, date-time — The time the event occurred. Must be between 24 hours in the past or 24 hours in the future. Defaults to `now` if not specified.
    - `id` string — Unique identifier for the change event.
    - `labels` object — Map of queryable labels, which are user-supplied key/value pairs associated with the event. * Max labels: 200 per event * Max key length: 200 characters * Max value length: 5,000 characters
    - `payload_json` string — A string-escaped representation of the original event in JSON format. You can set only `payload_json` or `payload_object`. This field is not queryable. Max length: 100,000 characters.
    - `payload_object` object — The JSON payload, if the original event was in key/value format. You can set only `payload_json` or `payload_object`. Max length: 100,000 characters. This field is input only.
    - `source` string — Identifies where the data originated, in cases where a change to the instrumentation or integration is needed. Max length: 50 characters.
    - `title` string — A short description of the event that occurred, such as a commit message of a code deploy. Max length: 100 characters.
    - `type` string — The event type, which is used to group and differentiate events within a `category` or `source`.

## Response `200`

A successful response.

- Datav1CreateEventResponse

## Other responses

- `default` — An unexpected error response.

---

[API](https://skmtc.dev/chronosphere/apis/data-v1-api.md) · [All operations](https://skmtc.dev/chronosphere/apis/data-v1-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/chronosphere/data-v1-api/revisions/ee91fd539ced/schema)