---
title: "Add or update events"
method: POST
path: "/v1/data_index/events"
tags: ["Data Index"]
---

# Add or update events

`POST /v1/data_index/events`

Events are actions your customers have performed. Use this endpoint to add new events or update existing events in your workspace. To associate events with customers, use our Pipelines or Track APIs. **NOTE:** If you add new events, they will not appear in your [Data Index](/journeys/people/find/using-data-index/) until you've associated it with a customer.

Add descriptions for events [so our AI tools can better understand your data](/ai/cio-with-llms/). For instance, this influences how our segment builder generates conditions with AI.

## Request body

- object
  - `events` object[], required — Array of event updates
    - `name` string, required — The name of the event
    - `description` string — The meaning of the event

## Response `204`

Events updated successfully

## Other responses

- `400` — Invalid request format
- `422` — Validation error
- `500` — Internal server error

---

[API](https://skmtc.dev/customer/apis/customer-io-journeys-api-reference.md) · [All operations](https://skmtc.dev/customer/apis/customer-io-journeys-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/customer/customer-io-journeys-api-reference/revisions/4b391af7cb06/schema)