Skip To Content ArcGIS for Developers Sign In Dashboard

Create User

  • URL:https://<users-url>/createUser(POST only)
  • Required Capability:Administrator
  • Related Resources:Users
  • Version Introduced:10.2.1

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.

password

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

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.

lastname

The last name for the user account.

role

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

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

Note:

Support for defining a custom role began at 10.6.1. For more information, see User types, roles, and privileges.

userLicenseTypeId

The user type for the account.

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

Note:

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

email

The email address for the user account.

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.

description

An optional description string for the user account.

f

The response format. The default response format is html.

Values: html | json

Example usage

https://server.domain.com/gis/portaladmin/security/users/createUser
username=jdoe@domain.com
firstname=John
lastname=Doe
role=org_publisher
userLicenseTypeId=creatorUT
email=jdoe@email.com
provider=enterprise
idpUsername=domain\jdoe
description=A publisher account for John Doe.