Create Integrated User

Overview

Use this API to create an integrated user. The logged in user can only create one user can at a time. Only department users can be created.

NOTE:

  • An integrated user gets its firstName, lastName, groups and password from Cisco Unified Contact Center Enterprise. Hence values for these attributes, if specified in the request body, are ignored.
  • For integrated users, only one of peripheral.id or externalId must be provided. Presence of both peripheral Id and externalId result in validation errors.
  • When externalId (i.e. personId) is specified, list of peripherals to which given personId belongs is fetched. User is created using the first peripheral obtained from the list.
  • "groups" is not in the list of allowed elements in the request body.

Permissions

Actor Permission
User All of the following are required:
  • If logged in user is a department user:
    • User must have 'Create User' action on 'User' resource.
    • User must be created in the home department of the logged in user, or in the department in which the logged in user is a foreign user.
  • If logged in user is a global user, one of the following is required:
    • User must have 'Administer' permission on the department in which the user is being created.
    • User must have 'Manage partition resources' privilege.
Client Application No additional permission is required.
SecurityoAuthUser or oAuthClient
Request
header Parameters
Accept
required
string
Default: application/json

Content type accepted by client.

Enum: "application/json" "application/xml"
Accept-Language
required
string
Default: en-US

Language locale accepted by client (used for locale specific fields in resource representation and in error responses).

Enum: "en-US" "es-ES" "fr-FR" "it-IT" "de-DE" "nl-NL" "pt-BR" "pt-PT" "da-DK" "ru-RU" "fr-CA" "zh-CN" "ja-JP" "ko-KR" "sv-SE"
Request Body schema: application/json
Any of:
object (title)

Title of the user.

firstName
required
string (firstName) [ 1 .. 124 ] characters [a-zA-Z0-9]|@|\s|:|.|_|-|&|[\x80-\xFF]

First name of the user.

middleName
string (middleName) [ 1 .. 124 ] characters [a-zA-Z0-9]|@|\s|:|.|_|-|&|[\x80-\xFF]

Middle name of the user.

lastName
required
string (lastName) [ 1 .. 124 ] characters [a-zA-Z0-9]|@|\s|:|.|_|-|&|[\x80-\xFF]

Last name of the user.

screenName
required
string (screenName) [ 1 .. 124 ] characters [a-zA-Z0-9]|@|\s|:|.|_|-|&|[\x80-\xFF]

Screen name of the user.

suffix
string (suffix) [ 1 .. 124 ] characters [a-zA-Z0-9]|@|\s|:|.|_|-|&|[\x80-\xFF]

Suffix of the user.

object (createdBy)

Details of the user who created this user.

loginId
required
string (loginId) <= 255 characters

Login ID of the user.

password
required
string (password)

Password for the user. This must adhere to the password complexity settings as configured in the application.

object (authenticationType)

Authentication type for the user.

object (status)

Status of the user.

object (manager)

Manager of the user.

emailAddress
string (emailAddress) <= 255 characters ^[a-zA-Z0-9-_]+@[a-zA-Z0-9-_]+\.[a-zA-Z0-9]+$...

Primary email address of the user.

mobileNumber
string (mobileNumber) [ 5 .. 20 ] characters

Mobile number of the user.

object (directReports)

Direct reports to the user.

required
object (departments)

Departments of the user.

object (groups)

Group details of the user.

object (languages)

Content languages of the user.

required
object (peripheral)

Peripheral which user belongs to (Applicable only for integrated users)

object (CustomAttributes)

Custom attributes for the user.

Responses
201

When created successfully

400

Bad Request

401

Unauthorized

403

Forbidden

406

Not Acceptable

500

Internal server error

post/integrated/user
Request samples
application/json
  • Creating a user by providing required attributes (Peripheral Id is provided instead of External Id).
  • POST /core/usermgr/v3/integrated/user
{
  • "firstName": "Anthony",
  • "lastName": "Shephard",
  • "screenName": "anthony",
  • "loginId": "ashephard",
  • "password": "password@123",
  • "departments": {
    },
  • "peripheral": {
    }
}
Response samples
application/json
{
  • "code": "400-101",
  • "developerMessage": "Unsupported query parameter(s) supplied: '<query_parameter>'."
}