POST
/
v1
/
notes
                    curl "https://api.mem.ai/v1/notes" \
                         --header "Content-Type: application/json" \
                         --header "Authorization: Bearer $MEM_API_KEY" \
                         --data '{
                             "content": "# Sales Call with Acme Corp

Contact: John Smith (john@acme.com)

Interested in enterprise plan. Follow up next week.",
                             "auto_organize": "Add this to both my Sales and Follow-ups collections",
                             "auto_format": "Format as a sales call summary with clear follow-up tasks"
                         }'
                    
{
  "content": "# Sales Call with Acme Corp\n\nContact: John Smith (john@acme.com)\n\nInterested in enterprise plan. Follow up next week.\n\n## Action Items\n- Schedule follow-up call next week\n- Send enterprise pricing information\n\n## Key Points\n- Interested in enterprise plan\n- Contact: John Smith (john@acme.com)",
  "created_at": "2025-04-11T04:47:14.457Z",
  "id": "5e29c8a2-c73b-476b-9311-e2579712d4b1",
  "operations": [
    {
      "collection_id": "3e4f5a6b-7c8d-9e0f-1a2b-3c4d5e6f7a8b",
      "collection_title": "Acme Corp",
      "collection_url": "https://mem.ai/collections/3e4f5a6b-7c8d-9e0f-1a2b-3c4d5e6f7a8b",
      "type": "created-collection"
    },
    {
      "collection_id": "3e4f5a6b-7c8d-9e0f-1a2b-3c4d5e6f7a8b",
      "collection_title": "Acme Corp",
      "collection_url": "https://mem.ai/collections/3e4f5a6b-7c8d-9e0f-1a2b-3c4d5e6f7a8b",
      "note_id": "5e29c8a2-c73b-476b-9311-e2579712d4b1",
      "note_title": "Sales Call with Acme Corp",
      "note_url": "https://mem.ai/notes/5e29c8a2-c73b-476b-9311-e2579712d4b1",
      "type": "added-note-to-collection"
    },
    "..."
  ],
  "request_id": "api-request-036ed6c7-de00-459f-a89b-43d26aafe522",
  "status": "completed",
  "title": "Sales Call with Acme Corp",
  "updated_at": "2025-04-11T04:47:19.702Z",
  "url": "https://mem.ai/notes/5e29c8a2-c73b-476b-9311-e2579712d4b1"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
content
string
required

Markdown formatted string representing the note content. The first line is automatically interpreted as the title.

Example:

"# Meeting with Product Team\n\nDiscussion Topics:\n- Roadmap updates\n- Feature prioritization\n\nAction Items:\n- Schedule follow-up with design\n- Share Q2 priorities document"

​
id
string | null

Optional UUID for the note. If provided, Mem will create a new note with the given ID.

Examples: • "123e4567-e89b-12d3-a456-426614174000"

​
add_to_collections
string[] | null

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"]

​
auto_organize

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"

​
apply_template

String representing a template title or ID to apply to the note content.

Example:

"Meeting Notes"

​
auto_format

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"

​
created_at
string | null

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"

​
updated_at
string | null

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 - application/json
OK
​
request_id
string
required
​
url
string
required
​
title
string
required
​
created_at
string
required
​
updated_at
string
required
​
content
string
required
​
operations
object[]
required
​
status
enum<string>
required
Available options:
completed,
failed,
unknown