When to use this article

This article may be used any time there is a need to create teams in bulk in Atlassian Cloud.

Prepare data

1. Use a text editor to prepare a text document listing the names of all teams to be created, as well as a second column providing a description if desired.
   
2. Ensure the first row has a header row labelled teamName,teamDescription  .
   While a description for the team is not required, it is mandatory for the REST API call.
   
3. Save the file as a csv, now containing a list of teams to be created.

Sample file

teamName,teamDescription
Transformers,Business transformation team
Project Matrix,
Platform CORE,
Team Cardguard,InfoSec
Pipedream,API team

Set up Postman

Find organization id

1. Navigate to admin.atlassian.com.
2. Select your organization if you have more than one.
3. Observe your organization id from the URL:
   https://admin.atlassian.com/o/<orgId>/overview
   where the org id is a GUID, for example:
   7d737580-498a-1b1c-kcd1-kdjj1d0bada9

Find site id

1. Navigate to admin.atlassian.com.
2. Select your organization if you have more than one.
3. Select Products from the top navigation bar.
4. In the left navigation pane, select a site.
5. Observe your site id from the URL:
   https://admin.atlassian.com/s//access-requests
   where the site id is a GUID, for example:
   6dbf9191-c42b-4988-97d7-45cb4f1112f7

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 Team in Atlassian Cloud".

4. Change the method from GET  to POST .

5. In the URL, paste:

   {{cloudUrl}}/gateway/api/public/teams/v1/org/<orgId>/teams/

6. Replace <orgId>  in the URL with the organization id previously obtained.

7. Click the "Authorization" tab.

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

9. Click the "Body" tab.
   

10. Click "raw".

11. Change the content type to "JSON".

12. Paste the following block in payload area:

    {
      "displayName": "{{teamName}}",
      "description": "{{teamDescription}}",
      "siteId": "<siteId>",
      "teamType": "OPEN"
    }

    noting the {{teamName}} and {{teamDescription}} match the csv header (case-sensitive).
    Accepted values for teamType are:
    

    teamType	Definition
    OPEN	Any member of your organization may join the team without approval.
    MEMBER_INVITE	Team members must be invited by a team administrator.

13. Replace <siteId>  in the URL with the site id previously obtained.
14. 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 Team 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 Teams at your site, for example, https://bancly.atlassian.net/jira/people/search to ensure the team has been added.
    Alternatively, open your Jira site, then click on Teams  in the top navigation bar.

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

References

• developer.atlassian.com - Team Public REST API
• developer.atlassian.com - Teams Public API
• Postman - Using the Collection Runner