---
title: "Create annotation"
method: POST
path: "/reader/books/{book_id}/annotations"
tags: ["Reader"]
---

# Create annotation

`POST /reader/books/{book_id}/annotations`

Create a new annotation (highlight, note, or bookmark)

## Path parameters

- `book_id` string, required

## Request body

- SchemaAnnotation
  - `book_id` string
  - `cfi` string
  - `chapter` string
  - `color` string
  - `content` string
  - `ctime` integer
  - `device_id` string
  - `id` integer
  - `page_number` integer
  - `position` string
  - `selected_text` string
  - `type` 'note' | 'highlight' | 'bookmark'
  - `user_id` integer
  - `utime` integer

## Response `200`

OK

- object
  - `data` SchemaAnnotation
    - `book_id` string
    - `cfi` string
    - `chapter` string
    - `color` string
    - `content` string
    - `ctime` integer
    - `device_id` string
    - `id` integer
    - `page_number` integer
    - `position` string
    - `selected_text` string
    - `type` 'note' | 'highlight' | 'bookmark'
    - `user_id` integer
    - `utime` integer

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.net/lxpio/apis/omnigram-api.md) · [All operations](https://skmtc.net/lxpio/apis/omnigram-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lxpio/omnigram-api/versions/58911ffb3093/schema)