Create a User - Medusa

Create an admin User. The user has the same privileges as all admin users, and will be able to authenticate and perform admin functionalities right after creation.

curl --location -g --request POST '{{BASE_URL}}/admin/users' \ --header 'Content-Type: application/json' \ --data-raw '{ "email": "user@example.com", "first_name": "string", "last_name": "string", "password": "pa$$word", "role": "admin" }'

{ "user": { "id": "usr_01G1G5V26F5TB3GPAPNJ8X1S3V", "email": "user@example.com", "first_name": "Levi", "last_name": "Bogan", "api_token": null, "created_at": "2019-08-24T14:15:22Z", "updated_at": "2019-08-24T14:15:22Z", "deleted_at": "2019-08-24T14:15:22Z", "role": "member", "metadata": { "car": "white" } } }

Request

Body Params application/json

string <email>

required

The User's email.

first_name

string

optional

The first name of the User.

last_name

string

optional

The last name of the User.

password

string <password>

required

The User's password.

role

enum<string>

optional

The role assigned to the user. These roles don't provide any different privileges.

Allowed values:

adminmemberdeveloper

Examples

Responses

🟢200OK

application/json

Body

user

object (User)

required

A User is an administrator who can manage store settings and data.

string

required

The user's ID

Example:

usr_01G1G5V26F5TB3GPAPNJ8X1S3V

string <email>

required

The email of the User

first_name

string | null

required

The first name of the User

Example:

Levi

last_name

string | null

required

The last name of the User

Example:

Bogan

api_token

string | null

required

An API token associated with the user.

Example:

null

created_at

string <date-time>

required

The date with timezone at which the resource was created.

updated_at

string <date-time>

required

The date with timezone at which the resource was updated.

deleted_at

string <date-time> | null

required

The date with timezone at which the resource was deleted.

role

enum<string>

required

The user's role. These roles don't provide any different privileges.

Allowed values:

adminmemberdeveloper

Default:

member

metadata

object | null

required

An optional key-value map with additional details

Example:

{"car":"white"}

🟠400Client Error or Multiple Errors

🟠401User is not authorized. Must log in first

🟠404Not Found Error

🟠409Invalid State Error

🟠422Invalid Request Error

🔴500Server Error