From Bright Pattern Documentation
< 5.2:User-management-api-specification
Revision as of 04:32, 29 May 2024 by BpDeeplTranslateMaintenance (talk | contribs) (Updated via BpDeleteTranslateTags script)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search
• 5.2

Create User

Creates a new user in the system.

Request

URL

http[s]://<host>/configapi/v2/user

For example:

http://example.com/configapi/v2/user

HTTP Method

POST

Content-Type

application/json

Parameters

Parameter Data-Type Description Example
loginId string The username of the new user "sheila.thomas"
firstName string The first name of the new user "Sheila"
lastName string The last name of the new user "Thomas"
team string The name of the team assigned to the new user "Customer Service"
extension number The user's extension number "1072"
workPhone string "4151234567" The user's work phone number
mobilePhone string "6501234567" The user's mobile phone number
email string The email address of the new user "sheila.thomas@yourcompany.com"
disabled Boolean Whether the user account is disabled ("true") or active ("false") false
changePassword Boolean Whether the user must change password ("true") upon next login or not ("false") false
skills object The skills and percentage values assigned to the user {"Spanish": 100, "English": 100}
roles array The role assigned to the new user ["Agent", "Supervisor"]

Example Request Body Content

{
    "loginId": "sheila.thomas",
    "password": "ChangeMe",
    "firstName": "Sheila",
    "lastName": "Thomas",
    "team": "Customer Service",
    "extension": "1072",
    "workPhone": "4151234567",
    "mobilePhone": "6501234567",
    "email": "sheila.thomas@nowhere.net",
    "disabled": false,
    "changePassword": true,
    "skills": {
        "Spanish": 100,
        "English": 100
    },
    "roles": [
        "Agent",
        "Supervisor"
    ]
}


Response

In response to a successful request, the new user is created. Verify the new user in Contact Center Administrator > Users & Teams > Users.

Failed requests result in an error code, and the user is not created.

Response Codes

Code Description
200 OK Success - user created
400 Bad request
405 Method not allowed
< Previous | Next >