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"
}
'import requests
url = "https://api.attention.tech/v2/organizations/users"
payload = {
"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"
}
headers = {
"Authorization": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
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'
})
};
fetch('https://api.attention.tech/v2/organizations/users', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.attention.tech/v2/organizations/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([
'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'
]),
CURLOPT_HTTPHEADER => [
"Authorization: <api-key>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.attention.tech/v2/organizations/users"
payload := strings.NewReader("{\n \"email\": \"15john.doe@example.com\",\n \"first_name\": \"John\",\n \"last_name\": \"Doe\",\n \"password\": \"SecureP@ssw0rd!\",\n \"roleUUID\": \"84e67f54-5157-442b-a2b3-8b9c728b2fef1\",\n \"teams\": [\n {\n \"uuid\": \"fe515723-fe2e-4959-a5fa-c4d3937fe7e4\",\n \"primary\": true\n },\n {\n \"uuid\": \"802a13d8-1ad0-4f4a-b880-9ace889fafa6\",\n \"primary\": false\n }\n ],\n \"seat_type\": \"recording\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "<api-key>")
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))
}HttpResponse<String> response = Unirest.post("https://api.attention.tech/v2/organizations/users")
.header("Authorization", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"email\": \"15john.doe@example.com\",\n \"first_name\": \"John\",\n \"last_name\": \"Doe\",\n \"password\": \"SecureP@ssw0rd!\",\n \"roleUUID\": \"84e67f54-5157-442b-a2b3-8b9c728b2fef1\",\n \"teams\": [\n {\n \"uuid\": \"fe515723-fe2e-4959-a5fa-c4d3937fe7e4\",\n \"primary\": true\n },\n {\n \"uuid\": \"802a13d8-1ad0-4f4a-b880-9ace889fafa6\",\n \"primary\": false\n }\n ],\n \"seat_type\": \"recording\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.attention.tech/v2/organizations/users")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"email\": \"15john.doe@example.com\",\n \"first_name\": \"John\",\n \"last_name\": \"Doe\",\n \"password\": \"SecureP@ssw0rd!\",\n \"roleUUID\": \"84e67f54-5157-442b-a2b3-8b9c728b2fef1\",\n \"teams\": [\n {\n \"uuid\": \"fe515723-fe2e-4959-a5fa-c4d3937fe7e4\",\n \"primary\": true\n },\n {\n \"uuid\": \"802a13d8-1ad0-4f4a-b880-9ace889fafa6\",\n \"primary\": false\n }\n ],\n \"seat_type\": \"recording\"\n}"
response = http.request(request)
puts response.read_body{
"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"
}
}{
"id": "not_found_error",
"status": "404",
"code": "404",
"title": "Not Found Error",
"detail": "The requested resource was not found",
"source": {
"pointer": "/data/attributes/id"
}
}{
"code": 401,
"message": "unauthenticated for Invalid API key"
}{
"code": 422,
"message": "Missing required fields in body"
}{
"code": "500",
"detail": "An unexpected error occurred on the server. Please try again later or contact support if the problem persists.",
"id": "internal_server_error",
"title": "Internal Server Error"
}{
"id": "not_found_error",
"status": "404",
"code": "404",
"title": "Not Found Error",
"detail": "The requested resource was not found",
"source": {
"pointer": "/data/attributes/id"
}
}Organization
Create User
Creates a new user in the specified organization. Requires a valid API key and proper permissions to create users. The user will be assigned to the specified team and given the specified role. Returns the created user’s details including their UUID.
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"
}
'import requests
url = "https://api.attention.tech/v2/organizations/users"
payload = {
"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"
}
headers = {
"Authorization": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
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'
})
};
fetch('https://api.attention.tech/v2/organizations/users', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.attention.tech/v2/organizations/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([
'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'
]),
CURLOPT_HTTPHEADER => [
"Authorization: <api-key>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.attention.tech/v2/organizations/users"
payload := strings.NewReader("{\n \"email\": \"15john.doe@example.com\",\n \"first_name\": \"John\",\n \"last_name\": \"Doe\",\n \"password\": \"SecureP@ssw0rd!\",\n \"roleUUID\": \"84e67f54-5157-442b-a2b3-8b9c728b2fef1\",\n \"teams\": [\n {\n \"uuid\": \"fe515723-fe2e-4959-a5fa-c4d3937fe7e4\",\n \"primary\": true\n },\n {\n \"uuid\": \"802a13d8-1ad0-4f4a-b880-9ace889fafa6\",\n \"primary\": false\n }\n ],\n \"seat_type\": \"recording\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "<api-key>")
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))
}HttpResponse<String> response = Unirest.post("https://api.attention.tech/v2/organizations/users")
.header("Authorization", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"email\": \"15john.doe@example.com\",\n \"first_name\": \"John\",\n \"last_name\": \"Doe\",\n \"password\": \"SecureP@ssw0rd!\",\n \"roleUUID\": \"84e67f54-5157-442b-a2b3-8b9c728b2fef1\",\n \"teams\": [\n {\n \"uuid\": \"fe515723-fe2e-4959-a5fa-c4d3937fe7e4\",\n \"primary\": true\n },\n {\n \"uuid\": \"802a13d8-1ad0-4f4a-b880-9ace889fafa6\",\n \"primary\": false\n }\n ],\n \"seat_type\": \"recording\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.attention.tech/v2/organizations/users")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"email\": \"15john.doe@example.com\",\n \"first_name\": \"John\",\n \"last_name\": \"Doe\",\n \"password\": \"SecureP@ssw0rd!\",\n \"roleUUID\": \"84e67f54-5157-442b-a2b3-8b9c728b2fef1\",\n \"teams\": [\n {\n \"uuid\": \"fe515723-fe2e-4959-a5fa-c4d3937fe7e4\",\n \"primary\": true\n },\n {\n \"uuid\": \"802a13d8-1ad0-4f4a-b880-9ace889fafa6\",\n \"primary\": false\n }\n ],\n \"seat_type\": \"recording\"\n}"
response = http.request(request)
puts response.read_body{
"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"
}
}{
"id": "not_found_error",
"status": "404",
"code": "404",
"title": "Not Found Error",
"detail": "The requested resource was not found",
"source": {
"pointer": "/data/attributes/id"
}
}{
"code": 401,
"message": "unauthenticated for Invalid API key"
}{
"code": 422,
"message": "Missing required fields in body"
}{
"code": "500",
"detail": "An unexpected error occurred on the server. Please try again later or contact support if the problem persists.",
"id": "internal_server_error",
"title": "Internal Server Error"
}{
"id": "not_found_error",
"status": "404",
"code": "404",
"title": "Not Found Error",
"detail": "The requested resource was not found",
"source": {
"pointer": "/data/attributes/id"
}
}Authorizations
Body
application/jsonapplication/vnd.api+json
The details of the user to be created.
The email address of the new user.
Example:
"user@example.com"
The first name of the new user.
Example:
"John"
The last name of the new user.
Example:
"Doe"
A list of teams the user will belong to. Each team requires a UUID.
Minimum array length:
1Show child attributes
Show child attributes
The UUID of the role assigned to the user.
The password for the new user's account.
The type of seat assigned to the user.
Available options:
listener, recording Example:
"recording"
Response
User successfully created
Show child attributes
Show child attributes
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"
}
Was this page helpful?
⌘I