This Use Case demonstrates how to automate the creation of users in Nimbus using Power Automate triggered by an Email. The process leverages the Nimbus API Endpoints to create users who are already present in your Entra ID / Active Directory, streamlining user management and reducing manual effort.

Following you will find a quick guide on how to:

• Create users in Nimbus via API using Postman.
• Create users in Nimbus via API using Power Automate and an Email trigger.

Creating a User via Postman

1. Create a new user in your AD and write down the user id.
2. In Nimbus Admin Portal go to Organization Units (OU) and open the OU in which you want to create the user.
3. Extract the OU ID from the URL and paste it to a note → See screenshot below:
   🧠 Note this ID down as you are going to use it later.

4. Go to Azure Portal and open the Application you created in the preconditions.
5. Copy the “Application (client) ID, paste it to your note”.
6. Open the “Endpoints” tab:
   
7. Copy the OAuth 2.0 token endpoint (V2)
   🧠 Note this URL down as you are going to use it later.
8. In Postman create a new collection. Within the collection create a request called “Authentication” and one called “User Creation”

8. In the top folder/the collection itself, add a variable called “secret” and add your secret value as the initial and current value

9. Now you can setup the authentication request. In the URL field at the top, choose “GET” and add the token URL you copied earlier on.

10. Now move over to “Body” at the top, tick “form-data” and fill add the following:

12. If you press “Send” you should receive a access token
    
13. Next, setup the “User Creation” request by choosing “POST” at the top and adding the Nimbus endpoint: https://portal.YourNimbusCluster.luware.cloud/api/public-api-next/user
14. In the “Authorization” tab, select the Auth Type “Bearer Token” and paste the token you generated previously.
    💡This Token will expire in 3599 seconds and needs to be renewed after
    💡Make sure you did not accidentally copy and empty spaces or line breaks into the token
15. Head over to the “Body” tab:
    1. Tick “raw”
    2. Make sure “JSON” is selected - this way we can just enter the raw JSON string
16. Enter the User ID from Step 1 and OU ID from Step 2 with the following schema:
    { "o365Id": "YourUserID", "organizationUnitId": "YourOUID"}
17. Press “Send”:
    ⮑ You should get back “200 OK”
    

If that all worked as expected, your endpoint is ready to use.

Create the Flow in Power Automate

With the endpoint working and the request setup, we can translate this to Nimbus Power Automate and then use it to create a users via Email.

1. Go to https://make.powerautomate.com and create a new “automated cloud flow”.
2. Start with a “When a new email arrives (V3)” trigger and sign in with your desired user.
   💡Power Automate will monitor the inbox for the user you choose here to trigger the flow. You can use your Power Automate user or select a dedicated user for this purpose.
3. Add a subject filter. This ensures that we wont put unnecessary load on the Nimbus endpoint. For this Use Case, we will use “New User”
   
4. Next we are going to configure the token request, for this, add an HTTP action
5. URI = the endpoint URL you copied in step 🧠 7. in the Postman setup above.
   Method = Post
   Headers = “Content-Type” - “application/x-www-form-urlencoded”
   Body = “grant_type=client_credentials&client_id=YourClientID&client_secret=YourClientSecret&scope=https://portal.innovator.luware.cloud/.default” - YourClientID from step 5 in the Postman setup and YourClientSecret from setting up the application in the prerequisites 
   
6. Add a “Parse JSON” action after. In the “content” field, add “Body” from the http dynamic content.
7. Paste this Schema in the field below:

{
    "type": "object",
    "properties": {
        "token_type": {
            "type": "string"
        },
        "expires_in": {
            "type": "integer"
        },
        "ext_expires_in": {
            "type": "integer"
        },
        "access_token": {
            "type": "string"
        }
    }
}

Your JSON should It should look something like this:

8. Add another HTTP action.
9. URI = https://portal.YourNimbusCluster.luware.cloud/api/public-api-next/user
   Method = Post
   Headers = “Content-Type” - “application/x-www-form-urlencoded”
“Authorization” - “Bearer @{body('Parse_JSON')?['access_token']}”
Body = “replace(triggerOutputs()?['body/subject'], 'New User ','')”
   ✅ With that setup, you should now be able to send mails in this format in order to create new users :
   1. To: the user you chose in Step 2. of the Power Automate setup
   2. Subject: New User { "o365Id": "YourUserID", "organizationUnitId": "YourOUID"}
      💡The next steps are optional, necessary only if you want to send a response back after a Nimbus user creation,
10. Add a condition, configure it to run after even if the previous http action succeeded, timed out, skipped or failed:
    
11. For the first value of the condition, from dynamic content, choose “Status code” for the previous http action. In the middle “is equal to” and the last value “200”.
    
12. Under the TRUE condition, add a “Send an email (V2)” action. In the “From” field, choose the dynamic content “From” provided by the Outlook trigger. 
13. Setup the rest as desired, something like this for example
    
14. Under the FALSE condition, do the same and adjust to communicated that the user creation failed