---
title: "Create a note"
method: POST
path: "/v2/notes"
tags: ["Notes"]
---

# Create a note

`POST /v2/notes`

Creates a new note for a given record.

Required scopes: `note:read-write`, `object_configuration:read`, `record_permission:read`.

## Request body

- object
  - `data` object, required
    - `parent_object` string, required — The ID or slug of the parent object the note belongs to.
    - `parent_record_id` string, uuid, required — The ID of the parent record the note belongs to.
    - `title` string, required — The note title. The title is plaintext only and has no formatting.
    - `format` 'plaintext' | 'markdown', required — Specify the format for the note's content. Choose from: - `plaintext`: Standard text format where `\n` signifies a new line. - `markdown`: Enables rich text formatting using a subset of Markdown syntax: - **Headings**: Levels 1-3 (`#`, `##`, `###`). - **Lists**: Unordered (`-`, `*`, `+`) and ordered (`1.`, `2.`). - **Text styles**: Bold (`**bold**` or `__bold__`), italic (`*italic*` or `_italic_`), strikethrough (`~~strikethrough~~`), and highlight (`==highlighted==`). - **Links**: Standard Markdown links (`[link text](https://example.com)`). *Note: While the Attio interface supports image embeds, they cannot currently be added or retrieved via the API's markdown format.*
    - `content` string, required — The main content of the note, formatted according to the value provided in the `format` field. Use `\n` for line breaks in `plaintext`. For `markdown`, utilize the supported syntax elements to structure and style your note.
    - `created_at` string — `created_at` will default to the current time. However, if you wish to backdate a note for migration or other purposes, you can override with a custom `created_at` value. Note that dates before 1970 or in the future are not allowed.
    - `meeting_id` string, uuid, nullable — An optional ID to associate this note with a meeting. If provided, the meeting must exist. Use `null` to explicitly set no meeting association.

## Response `200`

Success

- object — Success
  - `data` Note, required
    - `id` object, required
      - `workspace_id` string, uuid, required — The ID of the workspace the note belongs to.
      - `note_id` string, uuid, required — The ID of the note.
    - `parent_object` string, required — The slug or ID of the parent object the note belongs to.
    - `parent_record_id` string, uuid, required — The ID of the parent record the note belongs to.
    - `title` string, required — The note title. The title is plaintext only and has no formatting.
    - `meeting_id` string, uuid, nullable, required — The ID of the meeting associated with this note, or null if no meeting is associated.
    - `content_plaintext` string, required — The plaintext representation of the note content. The line feed character `\n` represents new lines within the note content.
    - `content_markdown` string, required — The markdown representation of the note content. Supports a subset of markdown features including: - Headings (levels 1-3 only with `#`, `##`, `###`) - Unordered lists (`-`, `*`, `+`) - Ordered lists (`1.`, `2.`, etc.) - Text styling: `**bold**`, `*italic*`, `~~strikethrough~~`, `==highlighted==` - Links: `[link text](https://example.com)` Note that note images are not returned as part of the markdown API representation.
    - `tags` union[], required — An array of records or workspace members that are @-tagged in the note content.
      - union
        - object
          - `type` 'workspace-member', required — The type of entity tagged in the note. Can be either 'workspace-member' or 'record'
          - `workspace_member_id` string, uuid, required — The ID of the workspace member that is tagged in the note.
        - object
          - `type` 'record', required — The type of entity tagged in the note. Can be either 'workspace-member' or 'record'
          - `object` string, required — The slug or ID of the object that the tagged record belongs to.
          - `record_id` string, uuid, required — The ID of the record that is tagged in the note.
    - `created_by_actor` object, required — The actor that created this note.
      - `id` string, nullable — An ID to identify the actor.
      - `type` 'api-token' | 'workspace-member' | 'system' | 'app', nullable — The type of actor. [Read more information on actor types here](/docs/actors).
    - `created_at` string, required — When the note was created.

## Other responses

- `404` — Not Found
- `413` — Content Too Large

---

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