---
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`

## Request

- Base URL: `https://api.apitraffic.io`
- URL: `https://api.apitraffic.io/v1/accounts/{accountSid}/events`
- Auth: none declared
- TypeScript: <https://skmtc.dev/apitraffic/apis/apitraffic-api-documentation/docs/v1/accounts/:accountSid/events/post.ts> (a function with typed inputs; its response is checked against the schema)

## 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.dev/apitraffic/apis/apitraffic-api-documentation.md) - [All operations](https://skmtc.dev/apitraffic/apis/apitraffic-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/apitraffic/apis/apitraffic-api-documentation/revisions/b2a22a9b5c98?raw)