Skip to content

Create new user

Administrators can add new users in a tenant by manually registering the user details from the management console.

Use the management console

  1. Log in to the WSO2 Identity Server Management Console (https://<IS_HOST>:<PORT>/carbon) using administrator credentials (admin:admin).

  2. Navigate to Main > Identity > Users and Roles > Add.

  3. Click Add New User.


  4. In the Domain list, select the user store in which you want to create this user account (e.g., Primary). This list includes the user stores you have configured.

  5. Enter a unique username and password. These are the credentials that the user will use to log in.


    Note that by default, the password must be atleast 5 characters.


  6. Click Finish or you can click Next to assign the user to a specific role. For more information about assigning a role, see the next section.

Use the SCIM 2.0 REST API

You can create a new user using a SCIM 2.0 request as shown below.


curl -v -k --user [username]:[password] --data '{"schemas":[],"name":{"familyName":[last name],"givenName":[name]},"userName":[username],"password":[password],"emails":[{"primary":[true/false],"value":[email address],"type":[home/work]},{"value":[email address 2],"type":[home/work]}]}--header "Content-Type:application/json" https://localhost:9443/scim2/Users

Below is a sample request to create a user and its corresponding response using SCIM 2.0.

Sample Request

curl -v -k --user admin:admin --data '{"schemas":[],"name":{"familyName":"jackson","givenName":"kim"},"userName":"kim","password":"kimwso2","emails":[{"primary":true,"value":"[email protected]","type":"home"},{"value":"[email protected]","type":"work"}]}' --header "Content-Type:application/json" https://localhost:9443/scim2/Users

Sample Response

            "value":"[email protected]",
            "value":"[email protected]"