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

In your application, log in as an Administrator user.

See Log in from an application for various ways to log in.
Call <<UNRESOLVED XREF>> 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.

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

In Connect Central, 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.
In your application, log in as an Administrator user.

Call <<UNRESOLVED XREF>> 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

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 ).