Create User

Create User

curl --request POST \
  --url https://api.attention.tech/v2/organizations/users \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "email": "[email protected]",
  "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": "[email protected]",
    "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"
  }
}

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": "[email protected]",
  "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": "[email protected]",
    "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"
  }
}

Authorizations

Authorization

string

header

required

Body

The details of the user to be created.

string

required

The email address of the new user.

Example:

"[email protected]"

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

Show child attributes

teams.uuid

string

required

The UUID of the team the user will belong to.

Example:

"f7c7fe28-ac4e-4181-a980-0f6ef98ca0e1"

teams.primary

boolean

Whether this team is the user's primary team.

Example:

true

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

Show child attributes

data.uuid

string

The unique identifier of the user.

Example:

"123e4567-e89b-12d3-a456-426614174000"

data.email

string

The email address of the user.

Example:

"[email protected]"

data.firstName

string

The first name of the user.

Example:

"John"

data.lastName

string

The last name of the user.

Example:

"Doe"

data.createdAt

string

The date and time the user was created.

Example:

"2021-01-01T00:00:00Z"

data.deletedAt

string

The date and time the user was deactivated.

Example:

"2021-01-01T00:00:00Z"

data.transcriptLang

string

The preferred transcript language for the user.

Example:

"en-US"

data.joinOutsideHostMeetings

boolean

Indicates if the user can join meetings outside their host organization.

Example:

true

data.realTimeCapabilities

boolean

Indicates if the user has real-time transcription capabilities.

Example:

false

data.settings

object

Show child attributes

data.settings.realTimeCapabilitiesOFF

boolean

data.settings.autoCalculateCRMFields

boolean

data.settings.joinWhenIAmHostAndAlone

boolean

data.settings.joinWhenIAmHostWithPeers

boolean

data.settings.joinWhenPeerIsHost

boolean

data.settings.joinWhenUnlicensedPeerIsHost

boolean

data.settings.dealsEnabled

boolean

Example:

{
  "realTimeCapabilitiesOFF": true,
  "autoCalculateCRMFields": true,
  "joinWhenIAmHostAndAlone": true,
  "joinWhenIAmHostWithPeers": true,
  "joinWhenPeerIsHost": true,
  "joinWhenUnlicensedPeerIsHost": true,
  "dealsEnabled": true
}

data.botName

string

The name of the bot associated with the user.

Example:

"MyBot"

data.botImageURL

string

The URL of the bot's profile image.

Example:

"https://example.com/bot.png"

data.primaryTeamUUID

string

The UUID of the user's primary team.

Example:

"primary-team-uuid-12345"

data.organizationRoleUUID

string

The UUID of the user's role in the organization.

Example:

"org-role-uuid-56789"

data.roles

object[]

A list of roles assigned to the user.

Show child attributes

data.roles.uuid

string

data.roles.name

string

data.roles.type

string

data.showReferralScreen

boolean

Whether the user is shown a referral screen.

Example:

false

data.seatType

string

The type of seat assigned to the user.

Example:

"admin"

data.teams

object[]

A list of teams assigned to the user.

Show child attributes

data.teams.uuid

string

Unique identifier of the team

Example:

"fe515723-fe2e-4959-a5fa-c4d3937fe7e4"

data.teams.name

string

Name of the team

Example:

"Engineering"

data.teams.phrases

string[]

List of keywords or phrases associated with the team

Example:

["engineering", "tech", "development"]

data.teams.slackConnection

object

Represents the Slack integration details for a team

Show child attributes

data.teams.slackConnection.id

string

Slack connection identifier

Example:

"T1234567890"

data.teams.slackConnection.info

object

Information about a connected Slack team

Show child attributes

data.teams.slackConnection.info.id

string

Slack team identifier

Example:

"T1234567890"

data.teams.slackConnection.info.name

string

Name of the Slack team

Example:

"Attention Tech"

data.teams.domain

string

Domain associated with the team

Example:

"attention.tech"

data.teams.organizerJoinInternalMeetings

boolean

Whether team organizers can join internal meetings

Example:

true

Whether email consent is enabled for the team

Example:

true

data.teams.parentTeamUUID

string

UUID of the parent team if this team is part of a hierarchy

Example:

"2ccf9bde-68e3-4de4-bc4e-51b927336665"

data.teams.organizationUUID

string

UUID of the organization this team belongs to

Example:

"16b78cec-82ef-46d2-8213-5d3bb7d2571c"

data.teams.children

array

List of child teams if this team has a hierarchical structure

List organization users Delete user

⌘I

Authentication

GI

Conversation

Team

ApiKey

User

Email

Tool

Scorecard

Opportunity

Organization

Calendar

Scim

Authorizations

Body

Response