---
title: "Create ticket note"
method: POST
path: "/v1/tickets/{id}/notes"
tags: ["tickets"]
---

# Create ticket note

`POST /v1/tickets/{id}/notes`

Creates an internal note on a ticket. Requires a token with write access.

## Path parameters

- `id` string, required — Ticket id.

## Query parameters

- `workspace_id` string — Optional workspace override. If omitted, Conduit resolves the ticket's workspace automatically.

## Request body

- object — Request body for creating an internal ticket note.
  - `body` string
  - `mention_user_ids` string[]
  - `attachments` object[]
    - `attachment_id` string, required — Convex storage id returned by the signed upload PUT response. This is the attachment id used by message and note APIs.
    - `name` string, required — Original filename to display.
    - `content_type` string, required — MIME content type supplied when the file was uploaded.
    - `content_length` integer, required — File size in bytes.

## Response `201`

Created ticket note

- object — Single ticket note response.
  - `data` object, required
    - `id` string, required
    - `workspace_id` string, required
    - `ticket_id` string, required
    - `contact_id` string, required
    - `body` string, required
    - `author` object, required
      - `user_id` string, nullable, required
      - `name` string, nullable, required
      - `email` string, nullable, required
      - `picture_url` string, nullable, required
    - `created_at` string, required
    - `updated_at` string, nullable, required
    - `attachments` object[], required
      - `url` string, required — Convex storage URL for the attachment. Long-lived (no signature expiry); fetched directly without auth.
      - `content_type` string, required
      - `name` string, nullable, required

## Other responses

- `400` — Invalid request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not found
- `429` — Rate limit exceeded

---

[API](https://skmtc.dev/conduit/apis/conduit-api.md) · [All operations](https://skmtc.dev/conduit/apis/conduit-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/conduit/conduit-api/revisions/3ad7e17f96ad/schema)