Skip to main content
POST
/
users
Create user
import requests

url = "https://{FUSION HOST}/api/users"

payload = {
    "username": "new-user-test",
    "password": "1testpassword",
    "roleNames": ["search", "developer"],
    "timezone": "Mountain Time (US & Canada)",
    "permissions": [{ "methods": ["GET", "POST", "PUT"] }]
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)
{
  "id": "be0885f2-9885-4c46-f3ea-8e5d0041c292",
  "username": "1new-user-test",
  "realmName": "native",
  "createdAt": "2025-10-30T21:59:01Z",
  "roleNames": [
    "search",
    "developer"
  ],
  "timezone": "Mountain Time (US & Canada)",
  "permissions": [
    {
      "methods": [
        "PUT",
        "POST",
        "GET"
      ]
    }
  ]
}

Body

application/json
​
username
string
required
​
id
string
​
realmName
string
default:native
​
password
string

Passwords must contain alpha+numeric chars and have a length of 8-20. Additional non-newline chars are allowed.

​
passwordHash
string
​
roleNames
string[]

Indicates which roles are dynamically applied to users in the realm.

​
timezone
string
Example:

"Pacific Time (US & Canada)"

​
permissions
object[]
​
realm
string
​
roles
string[]

One or more user roles. Use GET /roles to get the list of existing roles.

Response

Created

​
id
string
Example:

"fe0885f2-8885-4c46-a3ea-8e5d0041c293"

​
username
string
Example:

"admin"

​
realmName
string
Example:

"ldap-internal"

​
createdAt
string<date-time>
Example:

"2025-09-23T17:48:07Z"

​
updatedAt
string<date-time>
Example:

"2025-10-31T12:28:04Z"

​
roleNames
string[]

Indicates which roles are dynamically applied to users in the realm.

Example:
["search", "developer"]
​
timezone
string
Example:

"Pacific Time (US & Canada)"

​
permissions
object[]