Skip To Content

Create User

Description

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

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.

Note:

For the purposes of this document, the password example below and in the Example usage section is written as a clear password. When actually performing this operation in the Portal Admin API directory, the information entered for the password parameter is masked. When the request is submitted, the password information is encrypted, as access to the Portal Admin API requires HTTPS to be in place.

Example

password=secretpassword
firstname

The first name for the user account.

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.

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

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

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


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"}