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

# Create user

`POST /users`

Use this endpoint to create a new user. The API will respond with the newly-created user object if successful, containing a `guid` that you'll set as the `user_guid` in other requests when required. Disabling a user means that accounts and transactions associated with it will not be updated in the background by MX. It will also restrict access to that user’s data until they are no longer disabled.

## Request body

- UserCreateRequestBody
  - `user` UserCreateRequest
    - `email` string
    - `id` string
    - `is_disabled` boolean
    - `metadata` string

## Response `200`

OK

---

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