Using Connect Enterprise Web Services

Basics > Create users

Create users

To create a new user, you need Administrator privilege. Adobe recommends that you create a user who belongs to the admins group for your application to use to make API calls that require Administrator privilege.

Create a new user and send a welcome e-mail

1. In your application, log in as an Administrator user.

   See "Log in from an application" for various ways to log in.

2. Call principal-update with at least these parameters:

   https://example.com/api/xml?action=principal-update
           &first-name=jazz&last-name=doe&login=jazz99@doe.com&password=hello
           &type=user&send-email=true&has-children=0&email=jazz99@doe.com
   

   The type must be user, has-children must be 0 or false, send-email must be true, and email must have a valid e-mail address.

   The server sends a welcome e-mail with login information to the user's e-mail address.

3. Parse the principal element in the response for the user's principal-id:

   <principal type="user" principal-id="2007184341" has-children="0"
           account-id="624520">
     <login>jammdoe@example.com</login> 
     <ext-login>jammdoe@example.com</ext-login> 
     <name>jamm doe</name> 
   </principal>
   

Create a new user without using an e-mail address as a login ID

1. In Enterprise Manager, navigate to Administration > Users and Groups > Edit Login and Password Policies. Make sure that Use E-mail Address as the Login is set to No.
2. In your application, log in as an Administrator user.
3. Call principal-update to create the new user, passing both login and email parameters:

   https://example.com/api/xml?action=principal-update&first-name=jazz
       &last-name=doe&login=jazz&email=jazzdoe@company.com
       &password=nothing&type=user&has-children=0
   

4. Parse the response for the principal-id of the new user:

   <principal type="user" principal-id="2007184341" has-children="0"
               account-id="624520">
     <login>jazzdoe@example.com</login> 
     <ext-login>jazzdoe@example.com</ext-login> 
     <name>jazz doe</name> 
   </principal>
   

   In the response, ext-login has the same value as login by default, until the user logs in successfully using external authentication (see "Log in using HTTP header authentication").

Send me an e-mail when comments are added to this page | Comment Report

Current page: http://livedocs.adobe.com/breeze/6/xml_api/03_perm4.htm

Add Comment