Create user
POST {{baseUrl}}/users?aid=1234
Creates a new user.
The following applies when creating a user:
* If the user is already a member of another ThousandEyes customer organization, the user must set their own login account group.
* Any update that includes accountGroupRoles is a replace-based update and not a delta-based update.
Request Params
| Key | Datatype | Required | Description |
|---|---|---|---|
aid | number | A unique identifier associated with your account group. You can retrieve your AccountGroupId from the /account-groups endpoint. Note that you must be assigned to the target account group. Specifying this parameter without being assigned to the target account group will result in an error response. |
Request Body
{"name"=>"User X", "email"=>"userx@thousandeyes.com", "loginAccountGroupId"=>"691", "accountGroupRoles"=>[{"accountGroupId"=>"315", "roleIds"=>["57", "1140"]}, {"accountGroupId"=>"315", "roleIds"=>["57", "1140"]}], "allAccountGroupRoleIds"=>["57", "1140"]}
HEADERS
| Key | Datatype | Required | Description |
|---|---|---|---|
Content-Type | string | ||
Accept | string |
RESPONSES
status: Created
{"name":"User X","email":"userx@thousandeyes.com","uid":"245","dateRegistered":"2020-07-17T22:00:54Z","loginAccountGroup":{"aid":"1234","accountGroupName":"Account A"},"accountGroupRoles":[{"accountGroup":{"aid":"1234","accountGroupName":"Account A"},"roles":[{"name":"Organization Admin","roleId":"35","isBuiltin":false,"hasManagementPermissions":false},{"name":"Organization Admin","roleId":"35","isBuiltin":false,"hasManagementPermissions":false}]},{"accountGroup":{"aid":"1234","accountGroupName":"Account A"},"roles":[{"name":"Organization Admin","roleId":"35","isBuiltin":false,"hasManagementPermissions":true},{"name":"Organization Admin","roleId":"35","isBuiltin":true,"hasManagementPermissions":true}]}],"allAccountGroupRoles":[{"name":"Organization Admin","roleId":"35","isBuiltin":false,"hasManagementPermissions":false},{"name":"Organization Admin","roleId":"35","isBuiltin":true,"hasManagementPermissions":false}],"_links":{"self":{"href":"https://api.thousandeyes.com/v7/link/to/resource/id","templated":false,"type":"reprehenderit of","deprecation":"deserunt","name":"nostrud sed labore Excepteur","profile":"dolore pariatur amet","title":"deserunt","hreflang":"irure non enim est"}}}