Skip to main content
POST
/
users
/
batch
Create a new batch of users
curl --request POST \
  --url https://production.runalloy.com/users/batch \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --header 'x-api-version: <x-api-version>' \
  --data '{
  "users": [
    {
      "username": "demo@runalloy.com",
      "fullName": "Gregg Mojica"
    }
  ]
}'
{
  "message": "success",
  "invalidUsers": [
    {
      "fullName": "Missing Username"
    },
    {
      "username": "alreadyexists123"
    }
  ]
}

Headers

Authorization
string
default:bearer YOUR_API_KEY
required

Your Embedded API key for authorization

x-api-version
string
default:2025-09
required

The version of the API to use. The current API version is 2025-09.

Body

application/json
users
object[]
required

An array of user objects to be created. Each object must contain a username (mandatory) and an optional fullName. Limited to 1000 users at a time.

Response

200

message
string
Example:

"success"

invalidUsers
object[]
I