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
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
1
password=secretpassword

firstname

The first name for the user account.

Example
1
firstname=John

lastname

The last name for the user account.

Example
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 | GISProfessionalStdUT | GISProfessionalAdvUT | viewerUT | fieldWorkerUT

email

The email address for the user account.

Example
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
1
idpUsername=domain\jdoe

description

An optional description string for the user account.

Example
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:

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

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.

You can no longer sign into this site. Go to your ArcGIS portal or the ArcGIS Location Platform dashboard to perform management tasks.

Your ArcGIS portal

Create, manage, and access API keys and OAuth 2.0 developer credentials, hosted layers, and data services.

Your ArcGIS Location Platform dashboard

Manage billing, monitor service usage, and access additional resources.

Learn more about these changes in the What's new in Esri Developers June 2024 blog post.

Close