Create user
import requests
url = "https://{FUSION_HOST}/api/users"
payload = { "username": "new-user-test" }
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)HttpResponse<String> response = Unirest.post("https://{FUSION_HOST}/api/users")
.header("Content-Type", "application/json")
.body("{\n \"username\": \"new-user-test\"\n}")
.asString();const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({username: 'new-user-test'})
};
fetch('https://{FUSION_HOST}/api/users', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));require 'uri'
require 'net/http'
url = URI("https://{FUSION_HOST}/api/users")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"username\": \"new-user-test\"\n}"
response = http.request(request)
puts response.read_bodypackage main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://{FUSION_HOST}/api/users"
payload := strings.NewReader("{\n \"username\": \"new-user-test\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://{FUSION_HOST}/api/users",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'username' => 'new-user-test'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}curl --request POST \
--url https://{FUSION_HOST}/api/users \
--header 'Content-Type: application/json' \
--data '
{
"username": "new-user-test"
}
'{
"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"
]
}
]
}{
"id": "fe0885f2-8885-4c46-a3ea-8e5d0041c293",
"username": "admin",
"realmName": "ldap-internal",
"createdAt": "2025-09-23T17:48:07Z",
"updatedAt": "2025-10-31T12:28:04Z",
"roleNames": [
"search",
"developer"
],
"timezone": "Pacific Time (US & Canada)",
"permissions": [
{
"methods": [
"GET"
],
"path": "/",
"params": {}
}
]
}Create user
Create a new user.
This API should only be called to manage users in the native security realm, which manages both authentication and authorization within the Fusion UI. Users from other security realms, such as LDAP or SAML, are managed directly by the Fusion auth proxy access control component. It referred to as the auth proxy because it handles both authentication and authorization for all requests to the Fusion REST API services for SSO services.
Before working with the User API to create a user, be sure the native security realm is set up and ready.
POST
/
users
Create user
import requests
url = "https://{FUSION_HOST}/api/users"
payload = { "username": "new-user-test" }
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)HttpResponse<String> response = Unirest.post("https://{FUSION_HOST}/api/users")
.header("Content-Type", "application/json")
.body("{\n \"username\": \"new-user-test\"\n}")
.asString();const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({username: 'new-user-test'})
};
fetch('https://{FUSION_HOST}/api/users', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));require 'uri'
require 'net/http'
url = URI("https://{FUSION_HOST}/api/users")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"username\": \"new-user-test\"\n}"
response = http.request(request)
puts response.read_bodypackage main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://{FUSION_HOST}/api/users"
payload := strings.NewReader("{\n \"username\": \"new-user-test\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://{FUSION_HOST}/api/users",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'username' => 'new-user-test'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}curl --request POST \
--url https://{FUSION_HOST}/api/users \
--header 'Content-Type: application/json' \
--data '
{
"username": "new-user-test"
}
'{
"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"
]
}
]
}{
"id": "fe0885f2-8885-4c46-a3ea-8e5d0041c293",
"username": "admin",
"realmName": "ldap-internal",
"createdAt": "2025-09-23T17:48:07Z",
"updatedAt": "2025-10-31T12:28:04Z",
"roleNames": [
"search",
"developer"
],
"timezone": "Pacific Time (US & Canada)",
"permissions": [
{
"methods": [
"GET"
],
"path": "/",
"params": {}
}
]
}Body
application/json
Response
Created
Was this page helpful?