---
title: "Create an Annotation"
method: POST
path: "/annotations"
tags: ["Annotations"]
---

# Create an Annotation

`POST /annotations`

Create an Annotation.

## Request body

- object
  - `activity_id` string, required
  - `period_id` string
  - `annotation_category_id` string, required
  - `name` string, required
  - `start_time` number, required — Epoch Timestamp, seconds since 1970-01-01T00:00:00Z
  - `start_centiseconds` number, required — Centiseconds part of epoch timestamp (hundredths of a second, a number between 0 and 99)
  - `end_time` number, required — Epoch Timestamp, seconds since 1970-01-01T00:00:00Z
  - `end_centiseconds` number, required — Centiseconds part of epoch timestamp (hundredths of a second, a number between 0 and 99)
  - `athlete_ids` string[] — Array of athlete IDs
  - `parent_id` string — Parent annotation ID
  - `draw_color` string
  - `row` number
  - `x` number
  - `y` number
  - `comment` string
  - `imported_id` string, nullable

## Response `200`

Newly created annotation

- object — Annotation
  - `id` string
  - `activity_id` string
  - `parent_id` string
  - `period_id` string
  - `name` string
  - `start_time` number — Epoch Timestamp, seconds since 1970-01-01T00:00:00Z
  - `start_centiseconds` number — Centiseconds part of epoch timestamp (hundredths of a second, a number between 0 and 99)
  - `end_time` number — Epoch Timestamp, seconds since 1970-01-01T00:00:00Z
  - `end_centiseconds` number — Centiseconds part of epoch timestamp (hundredths of a second, a number between 0 and 99)
  - `draw_color` string — HTML color, e.g. #FF5500, the color to use when displaying this annotation on the timeline
  - `row` integer — Controls vertical position (row) when displaying this annotation on the timeline
  - `created_at` string
  - `modified_at` string
  - `x` number
  - `y` number
  - `comment` string
  - `imported_id` string, nullable
  - `annotation_category` object — Annotation Category
    - `id` string
    - `name` string — Display name
    - `import_name` string — Internal name
    - `start_offset` integer — Pre-roll in whole seconds
    - `end_offset` integer — Post-roll in whole seconds
    - `default_color` string — HTML color, e.g. #FF5500, the color to use for annotations of this type
    - `is_bakeable` integer — 0(false) or 1(true) annotation category should be baked. If is_event = 1 then is_bakeable will be 0
    - `is_event` integer — 0(false) or 1(true). An event might be a single event in time (like a Goal Keeper Save) vs a period of time (like ball in possession)
    - `created_at` string
    - `modified_at` string
    - `is_editable` integer
  - `annotation_metadata` object[]
    - `id` string
    - `name` string
    - `value` string
    - `is_visible` integer
    - `created_at` string
    - `modified_at` string
    - `type` integer
  - `athlete_ids` string[] — Array of athlete ids on annotation

## Other responses

- `401` — Unauthorized
- `404` — Activity Not Found

---

[API](https://skmtc.net/catapultsports/apis/openfield-connect-v6-api.md) · [All operations](https://skmtc.net/catapultsports/apis/openfield-connect-v6-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/catapultsports/openfield-connect-v6-api/revisions/b68eadaba68c/schema)