---
title: "POST /v1/users/"
method: POST
path: "/v1/users/"
tags: ["users"]
---

# POST /v1/users/

`POST /v1/users/`

Create a new User.

## Request body

- CreateUser
  - `user_id` string, required
  - `metadata` object

## Response `201`

User created successfully.

- UserResponse — Response returned after creating a User.
  - `id` integer — Internal numeric identifier.
  - `user_id` string
  - `metadata` object
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `graph_entities` unknown
  - `is_deleted` boolean
  - `project` integer — Internal numeric identifier of the project this record belongs to.

## Changes

- **2026-08-04** `d8043b07769d` — 2 breaking, 6 info
  - the response property `user_id` became optional for the status `201`
  - the `user_id` response property's minLength was decreased from `1` to `0` for the response status `201`
  - added the optional property `created_at` to the response with the `201` status
  - added the optional property `graph_entities` to the response with the `201` status
  - …4 more

[Change history](https://skmtc.dev/mem0/apis/mem0-api-docs/changes/v1/users/post.md)

---

[API](https://skmtc.dev/mem0/apis/mem0-api-docs.md) · [All operations](https://skmtc.dev/mem0/apis/mem0-api-docs/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/mem0/mem0-api-docs/revisions/062693546f67/schema)