---
title: "Create an event"
method: POST
path: "/v1/changeevents"
tags: ["changeEvents"]
---

# Create an event

`POST /v1/changeevents`

## Request body

- ChangeEventsChangeEvent
  - `id` integer — Optional ID of the event. It is recommended to leave this empty when creating a new event so that a unique ID will be generated
  - `name` string, required — The name of the event. Can be used as a category or type of event. Does not need to be unique.
  - `title` string, required — A short, high-level summary of the event.
  - `timestamp` integer — Timestamp of the event in seconds since the epoch. Defaults to the current time.
  - `source` string — Description of the event's origination. For example, a hostname, user, or application name.
  - `description` string — Extra metadata about the event describing the specifics of the event.
  - `parentEventId` integer — The id of the parent event
  - `tags` object — A set of key-value pairs that describe the event
  - `links` CommonLink[] — A set of links to related resources
    - `rel` string, required — Relationship of the link to the current resource.
    - `href` string, required — URL of the linked resource.
    - `label` string — Display label for the link.

## Response `202`

The ID of the created event

- object
  - `id` integer, required — Resource identifier.

## Other responses

- `400` — The server could not understand the request due to invalid syntax.
- `401` — Access is unauthorized.
- `500` — Server error

---

[API](https://skmtc.net/solarwinds/apis/solarwinds-observability.md) · [All operations](https://skmtc.net/solarwinds/apis/solarwinds-observability/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/solarwinds/solarwinds-observability/revisions/93dcde642260/schema)