POST
/
users
curl --request POST \
  --url https://api.eu.bronto.io/users \
  --header 'Content-Type: application/json' \
  --header 'X-BRONTO-API-KEY: <api-key>' \
  --data '{
  "first_name": "Alice",
  "last_name": "Smith",
  "email": "alice@company.com",
  "roles": [
    "Admin,",
    "Standard",
    "ReadOnly"
  ]
}'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "first_name": "John",
  "last_name": "Doe",
  "email": "john@company.com",
  "roles": [
    "ReadOnly",
    "Standard"
  ],
  "last_logins": {
    "Okta": 1731370728,
    "Password": 1731338939
  },
  "tags": {
    "region": "eu",
    "environment": "production"
  }
}

Authorizations

​
X-BRONTO-API-KEY
string
header
required

Body

application/json
​
first_name
string
required

The user's first name

Required string length: 1 - 255
Example:

"Alice"

​
last_name
string
required

The user's last name

Required string length: 1 - 255
Example:

"Smith"

​
email
string
required

The user's email address

Example:

"alice@company.com"

​
roles
string[]
required

A list of role ids

Example:
["Admin,", "Standard", "ReadOnly"]

Response

201
application/json
User created successfully
​
id
string
required

The unique identifier for the user

​
first_name
string
required

The user's first name

Example:

"John"

​
last_name
string
required

The user's last name

Example:

"Doe"

​
email
string
required

The user's email address

Example:

"john@company.com"

​
roles
string[]

A list of role ids

Example:
["ReadOnly", "Standard"]
​
last_logins
object

A map of login methods to their last login timestamps (Unix epoch).

Example:
{
  "Okta": 1731370728,
  "Password": 1731338939
}
​
tags
object

A map of key value pairs associated with this log

Example:
{
  "region": "eu",
  "environment": "production"
}