Create user on current org

createOrgUser is very similar to create, but with different permissions and is meant for administrators within a specific org hierarchy. The orgId field is not required and defaults to the selected org

Request
Security:
vc-security
Request Body schema: application/json
  • The username must be at least one character and cannot contain the characters "/" or "%2F".
  • If the primary phone is sent, it is mandatory to send a phone country code.
  • Depending on the type of user, other fields may be required.
object (UserKey)
password
string
orgId
string
email
string
enabled
boolean
locked
boolean
forcePasswordChange
boolean
Default: false
expired
boolean
credentialsExpired
boolean
usingMfa
boolean
mfaSecret
string
sharedSecret
string
notes
string
createdInstant
string <date-time>
lastUpdatedInstant
string <date-time>
createdBy
string
lastUpdatedBy
string
lastName
string
firstName
string
primaryPhone
string
primaryPhoneCountryCode
string
primaryPhoneExtension
string
lastSuccessfulAuthAttempt
string <date-time>
lastFailedAuthAttempt
string <date-time>
timeZone
string
locale
string
required
Array of objects (Role) unique
Default: []
required
Array of objects (Privilege) unique
Default: []
required
Array of objects (Role) unique
required
Array of objects (Privilege) unique
id
string
isSsoUser
boolean
Default: false
Responses
200

OK

400

Bad Request. The request parameters (or body) were malformed or invalid. Fix the issues with the request and try again.

401

Unauthorized request. Make sure token was included and is valid and try again.

403

Forbidden. You are not permitted to access the requested resource.

409

Conflict with the current state of the target resource.

500

Internal Server Error. An unexpected error has occurred. This may be due to a transient error. Retry the request and if the issue persists, please contact support.

post/user-service/v1/user/org
Request samples
application/json
{
  • "userKey": {
    },
  • "password": "string",
  • "orgId": "string",
  • "email": "string",
  • "enabled": true,
  • "locked": true,
  • "forcePasswordChange": false,
  • "expired": true,
  • "credentialsExpired": true,
  • "usingMfa": true,
  • "mfaSecret": "string",
  • "sharedSecret": "string",
  • "notes": "string",
  • "createdInstant": "2019-08-24T14:15:22Z",
  • "lastUpdatedInstant": "2019-08-24T14:15:22Z",
  • "createdBy": "string",
  • "lastUpdatedBy": "string",
  • "lastName": "string",
  • "firstName": "string",
  • "primaryPhone": "string",
  • "primaryPhoneCountryCode": "string",
  • "primaryPhoneExtension": "string",
  • "lastSuccessfulAuthAttempt": "2019-08-24T14:15:22Z",
  • "lastFailedAuthAttempt": "2019-08-24T14:15:22Z",
  • "timeZone": "string",
  • "locale": "string",
  • "roles": [ ],
  • "privileges": [ ],
  • "allRoles": [
    ],
  • "allPrivileges": [
    ],
  • "id": "string",
  • "isSsoUser": false
}
Response samples
application/json
{
  • "message": "Field \"name\" cannot be null",
  • "status": 400,
  • "error": "Bad Request",
  • "timestamp": "2023-12-13T19:02:31.5897497",
  • "path": "/user-service/v1"
}