Skip to main content
POST
/
organizations
/
users
Create User
curl --request POST \
  --url https://api.attention.tech/v2/organizations/users \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "email": "15john.doe@example.com",
  "first_name": "John",
  "last_name": "Doe",
  "password": "SecureP@ssw0rd!",
  "roleUUID": "84e67f54-5157-442b-a2b3-8b9c728b2fef1",
  "teams": [
    {
      "uuid": "fe515723-fe2e-4959-a5fa-c4d3937fe7e4",
      "primary": true
    },
    {
      "uuid": "802a13d8-1ad0-4f4a-b880-9ace889fafa6",
      "primary": false
    }
  ],
  "seat_type": "recording"
}
'
{
  "data": {
    "botName": "John's Notetaker",
    "email": "15john.doe@example.com",
    "firstName": "John",
    "lastName": "Doe",
    "primaryTeamUUID": "fe515723-fe2e-4959-a5fa-c4d3937fe7e4",
    "settings": {
      "autoCalculateCRMFields": true,
      "joinWhenIAmHostAndAlone": true,
      "joinWhenIAmHostWithPeers": true,
      "joinWhenUnlicensedPeerIsHost": true,
      "realTimeCapabilitiesOFF": true,
      "seat_type": "recording"
    },
    "transcriptLang": "en",
    "uuid": "c74eb7bc-7b0e-45e2-843a-67305bfc4dce"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.attention.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Body

The details of the user to be created.

​
email
string
required

The email address of the new user.

Example:

"user@example.com"

​
first_name
string
required

The first name of the new user.

Example:

"John"

​
last_name
string
required

The last name of the new user.

Example:

"Doe"

​
teams
object[]
required

A list of teams the user will belong to. Each team requires a UUID.

Minimum array length: 1
​
roleUUID
string
required

The UUID of the role assigned to the user.

​
password
string

The password for the new user's account.

​
seat_type
enum<string>
default:recording

The type of seat assigned to the user.

Available options:
listener,
recording
Example:

"recording"

Response

User successfully created

​
data
object
Example:
{
  "uuid": "123e4567-e89b-12d3-a456-426614174000",
  "email": "user@example.com",
  "firstName": "John",
  "lastName": "Doe",
  "createdAt": "2021-01-01T00:00:00Z",
  "transcriptLang": "en-US",
  "joinOutsideHostMeetings": true,
  "realTimeCapabilities": false,
  "botName": "MyBot",
  "botImageURL": "https://example.com/bot.png",
  "primaryTeamUUID": "primary-team-uuid-12345",
  "organizationRoleUUID": "org-role-uuid-56789",
  "showReferralScreen": false,
  "seatType": "admin"
}