Showing results for 
Search instead for 
Did you mean: 
Sign up Log in

Earn badges and make progress

You're on your way to the next level! Join the Kudos program to earn points and save your progress.

Deleted user Avatar
Deleted user

Level 1: Seed

25 / 150 points

Next: Root


1 badge earned


Participate in fun challenges

Challenges come and go, but your rewards stay with you. Do more to earn more!


Gift kudos to your peers

What goes around comes around! Share the love by gifting kudos to your peers.


Rise up in the ranks

Keep earning points to reach the top of the leaderboard. It resets every quarter so you always have a chance!


Bulk Change Managed User Email Addresses

Prince Nyeche
Rising Star
Rising Star
Rising Stars are recognized for providing high-quality answers to other users. Rising Stars receive a certificate of achievement and are on the path to becoming Community Leaders.
Jul 01, 2020

At a certain point in an Organization, there will come a time when there's a change of Infrastructure or process or even the Organization as a whole. This can result in different change management processes and administration of users can get tedious, especially when your organization is transitioning from one domain to another. Managing these users or changing their email addresses can be cumbersome when you have hundreds or even thousands of users. Instead of performing each change, one by one, you can be able to use a bulk method.

Here is where this workaround comes in. which involves using a Bash Script; however it involves the use of Atlassian's User REST API, a CSV file, a BASH environment and the ability to follow the 2 simple steps below.

Download the Script from Github here

→ The Idea here is that the <new email Address> must not exist as an Atlassian Account

→ If changing different Domains, both domains or those domains must have been claimed.

→ Generate API Key from{organizationId}/admin-api where {organizationId} is referring to the alphanumeric string of your Organization.

Note: Subscription to Atlassian Access might be required.


Step 1:

  • Navigate to your Instance Admin Hub

  • Click on Export Users, on the upper right corner of the screen. this will give you a list of users on the Instance

  • export-users.png
  • Open the CSV file and you'll, notice the columns available. We want the columns in the below format as that’s what is essential to making this work (since you'll have exported directly from Atlassian User Hub. From the email column, change the email to the <New Email Address> that you want, leave the rest columns the way it is.
  • table.png
  • P/S: Depending on how many Applications you own, you might have Additional Columns, however we want only 6 columns at any given time or if you know what you're doing, modify the script to suite the number of columns.

    → Also, remove the headers of the CSV file as that won’t be needed.

Step 2:

  • Make sure that you have user permission right on the file.

  • On your Terminal, run 

  • $:chmod u+x <filename>.sh
  • Then to initiate the script run 

  • $:./<filename>.sh

Follow the prompt to perform the action. For Windows Users, you might need to download CMder which will provide you a BASH environment to initialize this script. (For - macOS and Linux users, Bash should work just fine.)




Log in or Sign up to comment
AUG Leaders

Atlassian Community Events