---
title: "Create a new Note"
method: POST
path: "/notes.json"
tags: ["Notes"]
---

# Create a new Note

`POST /notes.json`

Outlines the parameters and data fields used when creating a new Note

## Query parameters

- `fields` string

## Headers

- `X-API-VERSION` string

## Request body

- object
  - `data` object, required
    - `contact` object, required
      - `id` integer, required — The unique identifier for a single Contact associated with the Note. The keyword null is not valid for this field. Required only if the Note type is `"Contact"`.
    - `date` string, date — Date for the Note. (Expects an ISO-8601 date).
    - `detail` string — Note body in text. This Note supports rich text when setting the `detail_text_type` field to `rich_text`. With supported tags such as `<a>`, `<b>`, `<br>`, `<div>`, `<em>`, `<i>` `<li>`, `<ol>`, `<p>`, `<s>`, `<strong>`, `<u>` and `<ul>`. This Note also supports attributes such as `href`, `rel`, `type`, and `target`.
    - `detail_text_type` string — The type of text in the detail field.
    - `matter` object, required
      - `id` integer, required — The unique identifier for a single Matter associated with the Note. The keyword null is not valid for this field. Required only if the Note type is `"Matter"`.
    - `notification_event_subscribers` object[]
      - `user_id` string, required — The unique identifier for a User to be added as a notification event subscriber to the Note.
    - `subject` string — Note subject.
    - `type` 'Matter' | 'Contact', required — Note type.

## Response `201`

Created

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `422` — Unprocessable Entity
- `429` — Too Many Requests

---

[API](https://skmtc.net/clio/apis/clio-api-documentation.md) · [All operations](https://skmtc.net/clio/apis/clio-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/clio/clio-api-documentation/revisions/73791ddd1207/schema)