createUser

Category	Metadata modification
Description	Create one or more users. If successful, the API will return a message for the user that has just been created. Supports creating no more than 1000 users in a single request.
Permissions Required To Invoke	User Permission
Parameters Required On Request	Credentials

This method's request contains a credentials tag to identify and authorize the calling user. User must have "User Permission" permission to create the user(s).

This method does not function following user synchronization from Workday.

Request Format


<?xml version='1.0' encoding='UTF-8'?>
<call method="createUser" callerName="a string that identifies your client application">
      <credentials login="sampleuser@company.com" password="my_pwd" />
        <users>
            <user
              email="newUser@company.com"
              name="new guy"
              password="new Password"
              alternateEmail="abc@greenco.com"
              samlFedId= "1234"
              permissionSetId="1"
              ownedLevels="2,3,7,11"
              timeZone="America/Mexico_City"
            />
       </users>
</call>

credentials element
Tag Name		credentials
Description		All API calls must contain a single credentials element to identify the user invoking the API. The API call is then performed as this user (any audit trail or history of actions in the system will show that this user performed the action), and therefore the user must have the required permissions to perform the action in order for the API call to succeed.
Attributes of the Element
Attribute Name	Required?	Value	Example
login	Y	The login name of the user invoking the API method. This user must have the required permissions to invoke the method	sampleuser@company.com
password	Y	The password of the user invoking the API method.	my_password
locale	N	Specify the locale to be used to interpret incoming numbers and dates, and to format outgoing numbers and dates (using the proper thousands separator, month names, and date formatting). The locale is also used to specify the language in which any system messages in the response should appear. If not specified, en_US (American English) is used.	fr_FR
instanceCode	N	If the user specified in the credentials has access to more than one instance of Adaptive Planning , this attribute can be used to specify that the user is intending to access an instance other than their default instance. If not specified, the user's default instance will be used. To determine the available instance codes, use the exportInstances API.	MYINSTANCE1
Contents of the Element
(none)

users element
Tag Name		users
Description		Contains one or more user elements.
Attributes of the Element
Attribute Name	Required?	Value	Example
Contents of the Element
Contains one or more user elements. Supports creating no more than 1000 users in a single request.

user element
Tag Name		user
Description		Specifies a user or users to create.
Attributes of the Element
Attribute Name	Required?	Value	Example
email	Y	The email address for this user. Uniqueness is required. The only allowed characters are a-z, A-Z, 0-9, - and .	newUser@company.com
name	Y	The name of this user.	Melvin Morsmere
position Available in API v39+	N	Position for user.	"CEO"
password	Y	The password of this user. This attribute is required except in the case of a Workday connected Instance that is User Sync enabled and uses Workday SAML SSO to log into Adaptive Planning.	newpassword
alternateEmail Available in API v27	N	The alternate email address for this user. We automatically select this option and populate with the email ID of the user in the User Details section.	abc@greenco.com
samlFedId Available in API v27	N	The SAML federation ID for this user.	1234, user@company.com
permissionSetId Available in API v25+	N	The internal system ID of the permission set assigned to this user.	3
roleId Available in API v25 and earlier Not available in API v25+	N	The internal system ID of the role assigned to this user. There is no default. (The roleId attribute is also covered in the exportRoles API.)	3
ownedLevels	N	The internal system ID for the levels separated by comma. There is no default. (The ownedLevels attribute is also covered in the exportLevels API.)	5,10,13
homepage Available in API v39+	N	Homepage for user.	"Welcome"
timeZone	N	The time zone of the user. If none is specified, it defaults to US/Pacific.	US/Pacific
country Available in API v39+	N	Country code for user (alpha-2 code).	"US"
usState Available in API v39+	N	State code for user (country has to be US).	"CA"
netsuiteLogin Available in API v39+	N	Netsuite login.	"abc@netsuite.com"
salesforceLogin Available in API v39+	N	Salesforce login.	"abc@salesforce.com"
Contents of the Element
(none)

Response Format


  <?xml version='1.0' encoding='UTF-8'?>
  <response success="true">
     <output>
         <result>
               <created_users>
                   <user success="true" message="user newUser@company.com was created successfully." guid="0CCF69803A990160E063820012ACFDD7"/>
               </created_users>
         </result>
     </output>
</response>

response element
Tag Name		response
Attributes of the Element
Attribute Name	Required?	Value	Example
success	Y	Either true or false, indicating whether the API call was successful or not. Even successful calls may contain warning messages in their response.	true
Contents of the Element
A single result element with created_user or updated_user status elements depending on whether a createUser or updateUser call was made, respectively.

result element
Tag Name		result
Description		Container for one or more status elements.
Attributes of the Element
Attribute Name	Required?	Value	Example
(none)
Contents of the Element
One or more created_user or updated_user status elements depending on whether a createUser or updateUser call was made, respectively.

created_users element
Tag Name		created_users
Description		Represents a message sent from the system back to the caller.
Attributes of the Element
Attribute Name	Required ?	Value	Example
user success	Y	The status returned by the call. Can be true or false.	true
message	Y	The status message.	usernewuser@company.com was created successfully.
guid	Y	The GUID of the user created.	"0CCF69803A990160E063820012ACFDD7"
Contents of the Element
One subscriptions element.