It's not the same without you

Join the community to find out what other Atlassian users are discussing, debating and creating.

Atlassian Community Hero Image Collage

Bulk Change Managed User Email Addresses

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
Community showcase
Published in Atlassian Access

We're launching improved navigation for admins

Hi Atlassian Community, My name is Avni Barman and I am a Product Manager on the Atlassian Access team! One of my top priorities is to help make the administrator's life easier through improved pro...

421 views 0 9
Read article

Community Events

Connect with like-minded Atlassian users at free events near you!

Find an event

Connect with like-minded Atlassian users at free events near you!

Unfortunately there are no Community Events near you at the moment.

Host an event

You're one step closer to meeting fellow Atlassian users at your local event. Learn more about Community Events

Events near you