---
title: "Add an internal note"
method: POST
path: "/tickets/{ticket}/note"
tags: ["Ticket messages"]
---

# Add an internal note

`POST /tickets/{ticket}/note`

## Request

- Base URL: `https://there-there.app/api`
- URL: `https://there-there.app/api/tickets/{ticket}/note`
- Auth: HTTP bearer

## Path parameters

- `ticket` string, required

## Headers

- `X-Workspace-Id` integer

## Request body

- object
  - `body` string, required
  - `attachment_ids` string[]: Upload tokens from POST /attachments. Embed a token as <img src="cid:TOKEN"> in the body to render it inline.

## Response `201`

Note message created

- object
  - `data` Message
    - `id` integer
    - `ulid` string
    - `type` 'inbound' | 'outbound' | 'note'
    - `body_html` string
    - `body_text` string, nullable
    - `sender` object
      - `id` integer
      - `type` 'contact' | 'user'
      - `name` string, nullable
      - `email` string, nullable
      - `avatar_url` string, nullable
    - `attachments` object[]: Files sent alongside the message. Fetch `url` (or `download_url`) with the same Bearer token, see `GET /attachments/{media}`.
      - `id` integer
      - `name` string
      - `url` string, uri
      - `download_url` string, uri
      - `size` integer
      - `mime_type` string
    - `inline_images` object[]: Images embedded inside `body_html` (typically bug screenshots customers paste into emails). Each item exposes a stable `url` matching the `<img src>` in the body, plus a `download_url` that forces a file download. Use these URLs with the same Bearer token to fetch the binary, see `GET /attachments/{media}`.
      - `id` integer
      - `name` string
      - `mime_type` string
      - `size` integer
      - `content_id` string, nullable
      - `url` string, uri
      - `download_url` string, uri
    - `is_forward` boolean
    - `send_status` 'demo' | 'pending' | 'sending' | 'sent' | 'failed', nullable: Delivery state of an outbound email. `null` for inbound messages, notes and support bubble replies, which have no delivery of their own. `sending` means a retry is in flight.
    - `created_at` string, date-time

---

[API](https://skmtc.dev/there-there/apis/there-there-api.md) · [All operations](https://skmtc.dev/there-there/apis/there-there-api/llms.txt) · [OpenAPI document](https://skmtc.dev/there-there/apis/there-there-api/revisions/1811fb0febc1?raw)