Skip To Content
ArcGIS Developers
Dashboard

Create User

Description

This operation pre-creates built-in or enterprise accounts in the portal. The provider parameter indicates the type of user account.

Note:

When an Enterprise portal is connected to an enterprise identity store, enterprise users sign in to the portal using their enterprise credentials. By default, new installations of portal do not allow accounts from an enterprise identity store to be registered to the portal automatically. Only users with accounts that have been pre-created can sign in to the portal. Alternatively, you can configure the portal to register enterprise accounts the first time the user connects to the website. See Update Security Configuration for details.

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

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

password=secretpassword
firstname

The first name for the user account.

Note:

At versions earlier than 10.4, the fullname parameter was used instead of a combination of firstname and lastname.

Example

firstname=John
lastname

The last name for the user account.

Example

lastname=Doe
role

The role for the user account. The default value is org_user.

Note:

Support for defining a custom role began at 10.6.1. For more information, 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.

Note:

Starting at 10.7, the following Partner user types are available: liteUT, basicUT, and standardUT.

Values: creatorUT | editorUT | GISProfessionalAdvUT | GISProfessionalBasicUT | GISProfessionalStdUT | viewerUT | fieldWorkerUT

email

The email address for the user account.

Example

email=jdoe@email.com
provider

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

Values: arcgis | enterprise

Example

provider=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

idpUsername=domain\jdoe
description

An optional description string for the user account.

Example

description=A publisher account for John Doe.
f

The response format. The default response format is html.

Values: html | json | pjson

Example usage

Below is a sample POST request for createUser:

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

{"status": "success"}