---
title: "Creates a new event marker (e.g. deployment, incident, config change)."
method: POST
path: "/v1/accounts/{accountSid}/events"
tags: ["Events"]
---

# Creates a new event marker (e.g. deployment, incident, config change).

`POST /v1/accounts/{accountSid}/events`

## Path parameters

- `accountSid` string, required — accountSid

## Request body

- Model22
  - `type` string, required — Event type (e.g. deployment, incident, config_change, scale, custom)
  - `name` string, required — Human-readable event name
  - `description` string, nullable — Optional longer description
  - `source` string, nullable — Source of the event (e.g. github_actions, gitlab_ci, jenkins, manual)
  - `metadata` Model19, nullable — Freeform key/value metadata (e.g. commitSha, branch, imageTag)
  - `bucketSids` string[] — Bucket sids this event applies to. Defaults to ["*"] (all).
  - `environmentSids` string[] — Environment sids this event applies to. Defaults to ["*"] (all).
  - `startedAt` string — When the event started. Defaults to now.
  - `endedAt` string, nullable — When the event ended. Null for point-in-time events.

## Response `200`

Successful

- Event
  - `sid` string, required — EventSid
  - `accountSid` string, required — Sid of the account
  - `bucketSids` string[], required — Bucket sids this event applies to
  - `environmentSids` string[], required — Environment sids this event applies to
  - `type` string, required — Event type (e.g. deployment, incident, config_change)
  - `name` string, required — Human-readable event name
  - `description` string, nullable — Optional longer description
  - `source` string, nullable — Source of the event (e.g. github_actions, jenkins)
  - `metadata` Metadata, nullable — Freeform key/value metadata
  - `startedAt` string, required — When the event started
  - `endedAt` string, nullable — When the event ended (null for point-in-time events)
  - `createdAt` string, required — When the record was created
  - `updatedAt` string, nullable — When the record was last updated

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.net/apitraffic/apis/apitraffic-api-documentation.md) · [All operations](https://skmtc.net/apitraffic/apis/apitraffic-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/apitraffic/apitraffic-api-documentation/revisions/b2a22a9b5c98/schema)