Create a new user

Production

https://api.getmarvia.com

POST

/v1/users

Required Permission: create:users

This endpoint requires an API key with the create:users permission. Make sure your token was created with this permission during token creation.

Request

Authorization

API Key

Add parameter in header

Authorization

Example:

Authorization: ********************

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢201Created

application/json

Success

Bodyapplication/json

🟠401Bad Request

🟠403Unauthorized

🟠409Conflict

🔴500Internal Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.getmarvia.com/v1/users' \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "username": "string",
    "email": "string",
    "firstName": "string",
    "lastName": "string",
    "countryCode": "st",
    "role": "administrator",
    "languageCode": "string"
}'

Response Example

201 - Example 1

{
    "_tag": "Success",
    "data": {
        "uuid": "string"
    }
}

Modified at 2026-08-20 06:19:01

List

List user locations