---
title: "Create Note"
method: POST
path: "/v1/notes"
tags: ["external", "external-v1"]
---

# Create Note

`POST /v1/notes`

## Request body

- LegacyCreateNoteRequestSchema
  - `add_to_collections` union[], nullable — Array of strings representing collection titles or IDs to add the note to. If a collection doesn't exist, a new one will be created. Examples: • ["Meetings", "Product", "Q2 Planning"] • ["8a7b6c5d-4e3f-2a1b-0c9d-8e7f6a5b4c3d", "Marketing"]
    - union
      - string
      - string, uuid
  - `apply_template` union — String representing a template title or ID to apply to the note content.
    - string
    - string, uuid
  - `auto_format` union — Boolean or string that controls automatic formatting. If true, Mem will automatically format the note content. If a string is provided, it will be used as custom formatting instructions. Examples: • True • "Use bullet points throughout and highlight key action items"
    - boolean
    - string
  - `auto_organize` union — Boolean or string that controls automatic organization. If true, Mem will automatically organize the note into relevant collections. If a string is provided, it will be used as custom organization instructions. Examples: • True • "Add this note to exactly one of my Marketing, Sales, or Recruiting collections"
    - boolean
    - string
  - `content` string, required — Markdown formatted string representing the note content. The first line is automatically interpreted as the title.
  - `created_at` string, date-time, nullable — When this note was created (ISO 8601 datetime string). Defaults to the current date and time. Example: • "2025-04-01T14:30:45Z" • "2023-12-15T09:45:30+01:00"
  - `id` string, uuid, nullable — Optional UUID for the note. If provided, Mem will create a new note with the given ID. Examples: • "123e4567-e89b-12d3-a456-426614174000"
  - `updated_at` string, date-time, nullable — When this note was last updated (ISO 8601 datetime string). Defaults to the same as created_at. Examples: • "2025-04-02T09:15:22Z" • "2023-12-15T09:45:30+01:00"

## Response `200`

OK

- LegacyCreateNoteResponseSchema
  - `content` string, required
  - `created_at` string, date-time, required
  - `id` string, uuid, required
  - `operations` union[], required
    - union
      - CreatedNoteSessionOperationSchema
        - `note_id` string, uuid, required
        - `title` string, required
        - `type` 'created-note'
        - `url` string, nullable
      - CreatedCollectionSessionOperationSchema
        - `collection_id` string, uuid, required
        - `title` string, required
        - `type` 'created-collection'
        - `url` string, nullable
      - AddedNoteToCollectionSessionOperationSchema
        - `collection_id` string, uuid, required
        - `collection_title` string, required
        - `collection_url` string, nullable
        - `note_id` string, uuid, required
        - `note_title` string, required
        - `note_url` string, nullable
        - `type` 'added-note-to-collection'
      - DeletedNoteSessionOperationSchema
        - `note_id` string, uuid, required
        - `type` 'deleted-note'
  - `request_id` string, required
  - `status` 'completed' | 'failed' | 'unknown', required
  - `title` string, required
  - `updated_at` string, date-time, required
  - `url` string, required

---

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