Use Postman to Create Users in Jira Cloud via REST APIs

Related content

  • No related content found

Still need help?

The Atlassian Community is here for you.

Ask the community

Platform Notice: Cloud - This article applies to Atlassian products on the cloud platform.

Summary

Learn how to efficiently create users in bulk for Jira or Confluence Cloud using this guide.

Prepare data

  1. Use a text editor to prepare a text document listing the email addresses of all users to be created.
    All users must have valid email addresses (with a mailbox attached) to later receive an email to reset their password upon first sign-in.
  2. Ensure the first row has a header row labelled emailAddress.
  3. Save the file as a CSV, now containing a list of email addresses with users to be created.
  4. Add a column labelled products for the default membership of the users.

Sample file

emailAddress,products
dgrechen@bancly.com,jira-software
khaulkham-fraben@bancly.com,jira-software
igunston2@bancly.com,jira-software
pmaynell3@bancly.com,jira-software

Set up Postman

This section may be skipped if:

  • A collection named "Atlassian Cloud User Management" has previously been setup, and

  • An environment named "Atlassian Cloud" has previously been setup

Click here for instructions to set up Postman

Download Postman

  1. Download Postman from https://www.postman.com/downloads/

  2. Run Postman.

Create a new environment

  1. Click New, or type Ctrl + N (Windows/Linux) or Cmd + N (MacOS).

  2. Select “Environment”.

  3. Name the environment “Atlassian Cloud”.

  4. Set up the following variables:

    VariableTypeInitial value and Current valueComments

    cloudUrl

    default

    https://<yoursite>.atlassian.net

    Replace yoursite with your subdomain, e.g. acmecorp

    apiTokenEmailAddress

    default

    <youruser@yourdomain.com>

    Your Atlassian administrator account email

    apiToken

    secret

    From https://id.atlassian.com/manage-profile/security/api-tokens

    Manage API tokens for your Atlassian account

    Note that Postman variables are case-sensitive.

  5. Click Save towards the top right corner.

Create a new collection

  1. Click New, or type Ctrl + N (Windows/Linux) or Cmd + N (MacOS).

  2. Select “Collection”.

  3. Name the collection “Atlassian Cloud User Management”.

  4. Click the “Authorization” tab.

  5. Change Type to “Basic Auth”.

  6. Specify {{apiTokenEmailAddress}} as the Username. The text should be coloured orange, indicating that Postman has recognized a variable has been specified. This can be confirmed by hovering over the variable name.

  7. Specify {{apiToken}} as the Password. The text should be coloured orange, indicating that Postman has recognized a variable has been specified. This can be confirmed by hovering over the variable name.

  8. Click the “Tests” tab.

  9. Enter:

    pm.test("Request successful", function () {
    pm.expect(pm.response.code).to.be.oneOf([200,201,202,204]);
});


    This allows us to ensure all REST APIs have been made successfully.

  10. Click Save towards the top right corner.

Set up REST API call

  1. Click New, or type Ctrl + N  (Windows/Linux) or Cmd  + N (MacOS).

  2. Select "HTTP".

  3. Name the request "Create User in Atlassian Cloud".

  4. Change the method from GET  to POST .

  5. In the URL, paste:

    {{cloudUrl}}/rest/api/2/user

  6. Click the "Authorization" tab.

  7. Ensure Type is "Inherit auth from parent".

  8. Click the "Body" tab.

  9. Click "raw".

  10. Change the content type to "JSON". Paste the following block in payload area:

    {
  "emailAddress": "{{emailAddress}}",
  "products": [
        "{{products}}" ]
}


    Noteo the {{emailAddress}} and {{products}} matches the csv header (case-sensitive).


  11. Click Save, saving into the "Atlassian Cloud User Management" collection.

Execute runner 

  1. Change the environment using the environment selector at the top right of Postman, selecting "Atlassian Cloud".

  2. Select Collections in the sidebar.

  3. Select the "Atlassian Cloud User Management" collection.

  4. On the Overview tab, select ▶️ Run towards the top right corner.

  5. Under Run order, ensure there is one and only REST API call - "Create User in Atlassian Cloud".

  6. On the Functional tab, select Run manually.

  7. Click Data.

  8. Navigate to and select the previously prepared csv file.

  9. Reduce the number of "Iterations" under Run configuration to 1.

  10. Leave Advanced settings as is.

  11. Click Run Atlassian Cloud User Management.

  12. Check Postman to ensure the runner collection has passed all tests. The run results should show:

    1. "Iterations" and "All tests" to be equivalent in count.

    2. Passed (n) where n is the number of iterations.

    3. Failed (0).

    4. Skipped (0).

  13. Check admin.atlassian.com to ensure the user count has been increased by one. Check the user's access permissions. They will inherit default access permissions.

  14. Rerun Postman Runner following the previous steps, with the number of "Iterations" set to the number of rows in the csv file.

References

For organizations with users and groups provisioned with Atlassian Guard SCIM, use the Atlassian Access User Provisioning REST API.





Last modified on May 6, 2025

Was this helpful?

Yes
No
Provide feedback about this article

Related content

  • No related content found
Powered by Confluence and Scroll Viewport.