Create User

URL:
https://<root>/security/users/createUser
Methods:
POST
Required Capability:
Access allowed with either the "Security and Infrastructure" or "Add" privileges
Version Introduced:
10.2.1

Description

The createUser operation allows organization administrators to pre-create either a built-in or enterprise accounts for an organization member. The type of account is determined by the value set for the provider parameter.

Request parameters

ParameterDetails

username

The name of the user account. User names cannot have more than 24 characters or fewer than 6 characters. They can only contain alphanumeric ASCII characters or underscores.

Example
Use dark colors for code blocksCopy
1
username=jdoe@domain.com

password

The password for the account. This is a required parameter only if provider is arcgis; otherwise, the password parameter is ignored.

Example
Use dark colors for code blocksCopy
1
password=secretpassword

firstname

The first name for the user account.

Example
Use dark colors for code blocksCopy
1
firstname=John

lastname

The last name for the user account.

Example
Use dark colors for code blocksCopy
1
lastname=Doe

role

The role for the user account. The default value is org_user. For more information on roles, see User types, roles, and privileges.

Values: org_admin | org_publisher | org_user | iBBBBBBBBBBBBBBB (Data Editor) | iAAAAAAAAAAAAAAA (Viewer)

userLicenseTypeId

The user type for the account.

Values: creatorUT | editorUT | GISProfessionalAdvUT | GISProfessionalBasicUT | GISProfessionalStdUT | viewerUT | fieldWorkerUT | liteUT (Partner user type) | basicUT (Partner user type) | standardUT (Partner user type)

email

The email address for the user account.

Example
Use dark colors for code blocksCopy
1
email=jdoe@email.com

provider

The provider for the account. The default value is arcgis.

Values: arcgis | enterprise

idpUsername

The name of the user as stored by the enterprise user store. This parameter is only required if the provider parameter is enterprise.

Example
Use dark colors for code blocksCopy
1
idpUsername=domain\jdoe

description

An optional description string for the user account.

Example
Use dark colors for code blocksCopy
1
description=A publisher account for John Doe.

f

The response format. The default response format is html.

Values: html | json | pjson

Example usage

The following is a sample POST request for the createUser operation:

Use dark colors for code blocksCopy
1
2
3
4
5
6
POST /webadaptor/portaladmin/security/users/createUser HTTP/1.1
Host: machine.domain.com
Content-Type: application/x-www-form-urlencoded
Content-Length: []

username=jdoe&password=test1234&firstname=Joe&lastname=Doe&role=org_user&userLicenseTypeId=creatorUT&email=joedoe@domain.com&provider=arcgis&idpUsername=&description=Creator+account+for+Joe+Doe&f=json

JSON Response example

Use dark colors for code blocksCopy
1
2
3
{
  "status": "success"
}

Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.