Post Deprecated /api/v3/user

Operation: CreateUserV3 Permissions: UsersAndUserGroups (Manage)

Summary

Create a new user. Requires Manage permission for Users & Roles

Request Body Parameters

Content-Type: application/json

Type Reference: UserCreateRequest

Parameter Description Type
userCode Required Must be between 0 and 65 characters string
fullName Required Must be between 0 and 32 characters string
password Required Must be between 0 and 128 characters string
email Required Must be between 0 and 128 characters string
costCenterId NOTE: This property will be deprecated
Use TopmostCostCenterIds with a single valued list to create a user with a single topmost cost center

Create User with a single topmost cost center id
The CostCenterId must be in the creating user’s topmost
If this value is not null then TopmostCostCenterIds must be null Topmost (CostCenter) Only one of CostCenterId, TopmostCostCenterIds can be set		 integer
topmostCostCenterIds Create User with one or multiple topmost cost center ids
The CostCenterIds must be in the creating user’s topmost
If this is not null then CostCenterId must be null Cannot be Empty NULL Valid Only one of CostCenterId, TopmostCostCenterIds can be set		 array
placeId NOTE: This property will be deprecated
Use TopmostPlaceIds with a single valued list to create a user with a single topmost place

Create User with a single topmost place id
The PlaceId must be in the creating user’s topmost
If this value is not null then TopmostPlaceIds must be null Topmost (Place) Only one of PlaceId, TopmostPlaceIds can be set		 integer
topmostPlaceIds Create User with one or multiple topmost place ids
The PlaceIds must be in the creating user’s topmost
If this is not null then PlaceId must be null Cannot be Empty NULL Valid Only one of PlaceId, TopmostPlaceIds can be set		 array
activeDirectory boolean
active boolean
passwordExpirationInterval Required integer
strongPassword Required boolean
forcePasswordChange Required boolean
userRoleId Required integer
maxApprovalAmount integer
reportGroupId integer
userGroups List of user group ids
If null, empty, or not passed the user will not be assigned to any groups		 array

Request Body

{
  "userCode": "string",
  "fullName": "string",
  "password": "string",
  "email": "string",
  "costCenterId": 1,
  "topmostCostCenterIds": [
    1
  ],
  "placeId": 1,
  "topmostPlaceIds": [
    1
  ],
  "activeDirectory": false,
  "active": false,
  "passwordExpirationInterval": 1,
  "strongPassword": false,
  "forcePasswordChange": false,
  "userRoleId": 1,
  "maxApprovalAmount": 1,
  "reportGroupId": 1,
  "userGroups": [
    1
  ]
}

Response Parameters

HTTP 200

Header Parameters

Header Description Type
ECI-Deprecated API version and if applicable the replacement operation name string


Body Parameters

Content Type: application/json

Type Reference: UserResponse

Parameter Description Type
userId User Identifier integer
userCode User Code string
fullName Full name of the user string
userRole SystemUserRoleChild
   userRoleId The user role identifier integer
   userRoleInfo The user role name string
costCenter TopmostCostCenter
   isMultiTopmostCostCenter User’s topmost combines multiple cost centers boolean
   multiTopmostCostCenters CostCenterChild [Array]
      costCenterId The cost center identifier integer
      costCenterCode The cost center code string
      costCenterInfo The cost center info string
   costCenterId The cost center identifier integer
   costCenterCode The cost center code string
   costCenterInfo The cost center info string
place TopmostPlace
   isMultiTopmostPlace User’s topmost combines multiple places boolean
   multiTopmostPlaces PlaceChild [Array]
      placeType PlaceTypeResponse
         placeTypeId The place type identifier integer
         placeTypeCode The place type code string
         placeTypeInfo The place type info string
         structure Indicates if the place is a structure boolean
         icon Icon
            code The icon code Must be between 0 and 64 characters Required when Color is set string
            color The icon color Must be between 0 and 32 characters Required when Code is set string
         placeEntityType PlaceEntityTypeV202406
            placeEntityTypeId The place entity type identifier integer
            placeEntityTypeInfo The place entity type name string
         isSystemPlaceType Flag to indicate if the place type is a system-level place type boolean
      isDataRolledUp Tells whether or not the place’s data is rolled up to its parents. boolean
      placeId The place identifier integer
      placeCode The place code string
      placeInfo The place info string
   placeType PlaceTypeResponse
      placeTypeId The place type identifier integer
      placeTypeCode The place type code string
      placeTypeInfo The place type info string
      structure Indicates if the place is a structure boolean
      icon Icon
         code The icon code Must be between 0 and 64 characters Required when Color is set string
         color The icon color Must be between 0 and 32 characters Required when Code is set string
      placeEntityType PlaceEntityTypeV202406
         placeEntityTypeId The place entity type identifier integer
         placeEntityTypeInfo The place entity type name string
      isSystemPlaceType Flag to indicate if the place type is a system-level place type boolean
   isDataRolledUp Tells whether or not the place’s data is rolled up to its parents. boolean
   placeId The place identifier integer
   placeCode The place code string
   placeInfo The place info string
collection TopmostCollection
   isMultiTopmostCollection User’s topmost combines multiple collections boolean
   multiTopmostCollections CollectionChild [Array]
      collectionId The collection identifier integer
      collectionCode The collection code string
      collectionInfo The collection info string
      collectionIcon Icon
         code The icon code Must be between 0 and 64 characters Required when Color is set string
         color The icon color Must be between 0 and 32 characters Required when Code is set string
   collectionId The collection identifier integer
   collectionCode The collection code string
   collectionInfo The collection info string
   collectionIcon Icon
      code The icon code Must be between 0 and 64 characters Required when Color is set string
      color The icon color Must be between 0 and 32 characters Required when Code is set string
activeDirectory Is this a active directory user? boolean
active User is active or inactive boolean
email Email ID of the user string
passwordExpirationInterval Days until password expires integer
strongPassword Does user need a strong password - at least 8 character long, one upper case, one number, one special char boolean
forcePasswordChange Should the user be forced to change password on next login boolean
maxApprovalAmount Max Total cost of bill this user is allowed to approve integer
lastLogin last time the user logged in string
reportGroup ReportGroupChildResponse
   reportGroupId integer
   reportGroupCode string
   reportGroupInfo string
externalUserId The external identifier for the user. This is only used for federated login. string
userGroups List of groups a user is a part of UserGroupChild [Array]
   userGroupId The user group identifier integer
   userGroupName The user group name string
space TopmostSpace
   isMultiTopmostPlace User’s topmost combines multiple places boolean
   multiTopmostPlaces PlaceChild [Array]
      placeType PlaceTypeResponse
         placeTypeId The place type identifier integer
         placeTypeCode The place type code string
         placeTypeInfo The place type info string
         structure Indicates if the place is a structure boolean
         icon Icon
            code The icon code Must be between 0 and 64 characters Required when Color is set string
            color The icon color Must be between 0 and 32 characters Required when Code is set string
         placeEntityType PlaceEntityTypeV202406
            placeEntityTypeId The place entity type identifier integer
            placeEntityTypeInfo The place entity type name string
         isSystemPlaceType Flag to indicate if the place type is a system-level place type boolean
      isDataRolledUp Tells whether or not the place’s data is rolled up to its parents. boolean
      placeId The place identifier integer
      placeCode The place code string
      placeInfo The place info string
   placeType PlaceTypeResponse
      placeTypeId The place type identifier integer
      placeTypeCode The place type code string
      placeTypeInfo The place type info string
      structure Indicates if the place is a structure boolean
      icon Icon
         code The icon code Must be between 0 and 64 characters Required when Color is set string
         color The icon color Must be between 0 and 32 characters Required when Code is set string
      placeEntityType PlaceEntityTypeV202406
         placeEntityTypeId The place entity type identifier integer
         placeEntityTypeInfo The place entity type name string
      isSystemPlaceType Flag to indicate if the place type is a system-level place type boolean
   isDataRolledUp Tells whether or not the place’s data is rolled up to its parents. boolean
   placeId The place identifier integer
   placeCode The place code string
   placeInfo The place info string

Responses

HTTP 200

Header

{
  "ECI-Deprecated": "string"
}

Body

Content Type: application/json
{
  "userId": 1,
  "userCode": "string",
  "fullName": "string",
  "userRole": {
    "userRoleId": 1,
    "userRoleInfo": "string"
  },
  "costCenter": {
    "isMultiTopmostCostCenter": false,
    "multiTopmostCostCenters": [
      {
        "costCenterId": 1,
        "costCenterCode": "string",
        "costCenterInfo": "string"
      }
    ],
    "costCenterId": 1,
    "costCenterCode": "string",
    "costCenterInfo": "string"
  },
  "place": {
    "isMultiTopmostPlace": false,
    "multiTopmostPlaces": [
      {
        "placeType": {
          "placeTypeId": 1,
          "placeTypeCode": "string",
          "placeTypeInfo": "string",
          "structure": false,
          "icon": {
            "code": "string",
            "color": "string"
          },
          "placeEntityType": {
            "placeEntityTypeId": 1,
            "placeEntityTypeInfo": "string"
          },
          "isSystemPlaceType": false
        },
        "isDataRolledUp": false,
        "placeId": 1,
        "placeCode": "string",
        "placeInfo": "string"
      }
    ],
    "placeType": {
      "placeTypeId": 1,
      "placeTypeCode": "string",
      "placeTypeInfo": "string",
      "structure": false,
      "icon": {
        "code": "string",
        "color": "string"
      },
      "placeEntityType": {
        "placeEntityTypeId": 1,
        "placeEntityTypeInfo": "string"
      },
      "isSystemPlaceType": false
    },
    "isDataRolledUp": false,
    "placeId": 1,
    "placeCode": "string",
    "placeInfo": "string"
  },
  "collection": {
    "isMultiTopmostCollection": false,
    "multiTopmostCollections": [
      {
        "collectionId": 1,
        "collectionCode": "string",
        "collectionInfo": "string",
        "collectionIcon": {
          "code": "string",
          "color": "string"
        }
      }
    ],
    "collectionId": 1,
    "collectionCode": "string",
    "collectionInfo": "string",
    "collectionIcon": {
      "code": "string",
      "color": "string"
    }
  },
  "activeDirectory": false,
  "active": false,
  "email": "string",
  "passwordExpirationInterval": 1,
  "strongPassword": false,
  "forcePasswordChange": false,
  "maxApprovalAmount": 1,
  "lastLogin": "2025-03-20",
  "reportGroup": {
    "reportGroupId": 1,
    "reportGroupCode": "string",
    "reportGroupInfo": "string"
  },
  "externalUserId": "string",
  "userGroups": [
    {
      "userGroupId": 1,
      "userGroupName": "string"
    }
  ],
  "space": {
    "isMultiTopmostPlace": false,
    "multiTopmostPlaces": [
      {
        "placeType": {
          "placeTypeId": 1,
          "placeTypeCode": "string",
          "placeTypeInfo": "string",
          "structure": false,
          "icon": {
            "code": "string",
            "color": "string"
          },
          "placeEntityType": {
            "placeEntityTypeId": 1,
            "placeEntityTypeInfo": "string"
          },
          "isSystemPlaceType": false
        },
        "isDataRolledUp": false,
        "placeId": 1,
        "placeCode": "string",
        "placeInfo": "string"
      }
    ],
    "placeType": {
      "placeTypeId": 1,
      "placeTypeCode": "string",
      "placeTypeInfo": "string",
      "structure": false,
      "icon": {
        "code": "string",
        "color": "string"
      },
      "placeEntityType": {
        "placeEntityTypeId": 1,
        "placeEntityTypeInfo": "string"
      },
      "isSystemPlaceType": false
    },
    "isDataRolledUp": false,
    "placeId": 1,
    "placeCode": "string",
    "placeInfo": "string"
  }
}