How to Access User Email Addresses via Jira Cloud API
Platform Notice: Cloud Only - This article only applies to Atlassian apps on the cloud platform.
Summary
You can use the Jira Cloud REST API to get users' email addresses.
Solution
Currently, there are three known API endpoints in the cloud that return an email address along with an Atlassian Account ID.
Need | Endpoint | Permission |
|---|---|---|
One user by accountId |
| Browse users and groups |
Search users by query |
| Browse users and groups |
Org-wide (managed accounts) | Organizations REST API - | Org admin API key |
Caveat
Even with the right permission, an endpoint returns an email only if the user's email visibility allows it. Managed accounts may hide email at the org level, regardless of Jira permissions — use the Organizations API for guaranteed access to managed-account emails. For more details, see the Profile visibility overview.
To easily retrieve all users' email addresses, use the user management page (<yourcompany>.atlassian.net/admin) on the website to export them.
How do I know it worked?
A test call /rest/api/3/user/search/query returns objects containing emailAddress for visible users.
Was this helpful?