---
title: "Create a note on a case"
method: POST
path: "/service_agents/contact_cases/{id}/notes"
tags: ["Service Agent"]
---

# Create a note on a case

`POST /service_agents/contact_cases/{id}/notes`

Create a new note on the case of the given ID, authored by the
calling agent. The author is derived server-side from the caller's
own agent identity -- the request only carries the note text, so an
agent can never author a note as another agent or as the system.
Notes are an internal, agent-facing annotation on a Case and never
appear in any customer-facing webhook or response.

## Path parameters

- `id` string, uuid, required

## Request body

- object
  - `text` string, required — The note's text content.

## Response `200`

Case note created successfully.

- ContactManagerCaseNote
  - `id` string, uuid — Unique identifier for the case note.
  - `customer_id` string, uuid — Unique identifier of the associated customer.
  - `case_id` string, uuid — The case this note belongs to. The ID is returned from GET /v1.0/contact_cases response.
  - `author_type` 'agent' | 'system' — Type of the note's author.
  - `author_id` string, uuid — ID of the agent authoring this note. Nullable for system-authored notes.
  - `text` string — The note's text content.
  - `tm_create` string, date-time — Timestamp when this note was created.
  - `tm_update` string, date-time — Timestamp when this note was last updated.
  - `tm_delete` string, date-time — Timestamp when this note was soft-deleted. Null if active.

## Other responses

- `400` — Invalid request (INVALID_ARGUMENT).
- `401` — Authentication required (UNAUTHENTICATED).
- `403` — Insufficient permission (PERMISSION_DENIED).
- `404` — Resource not found (NOT_FOUND).
- `500` — Internal error (INTERNAL).

---

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