Your Jira account ID, a unique identifier for your Atlassian profile, can primarily be found by inspecting the URL of your user profile page or by utilizing the Jira REST API. This ID is crucial for various integrations, automation, and advanced user management across Atlassian products.
How to Get Your Jira Account ID
Getting your Jira (or more accurately, Atlassian) account ID involves a few straightforward methods, catering to different user needs and technical proficiencies. This ID is a persistent, globally unique identifier that allows Atlassian to manage user data consistently across all their services, including Jira, Confluence, and Bitbucket.
1. Via Your Atlassian Profile URL (Most Common Method)
The most accessible way to locate your Atlassian account ID is by simply navigating to your personal Atlassian profile. When you open your profile, your unique account ID is typically embedded directly within the browser's address bar. This method works regardless of your Jira plan, including Free Jira instances.
Steps to Find Your Account ID via Profile:
-
Log In to Jira: Open your Jira instance and ensure you are logged into your Atlassian account.
-
Access Your Profile:
- Click on your profile avatar (usually located in the bottom-left corner or top-right corner of your Jira interface).
- From the dropdown menu, select "Profile" or "Manage account". This action will typically redirect you to your main Atlassian account page (e.g.,
id.atlassian.com
).
-
Examine the URL: Once your profile page loads, look at the URL in your web browser's address bar. Your account ID is a long, alphanumeric string that commonly appears as a query parameter (e.g.,
accountid=
,user_id=
) or as a segment within the URL path.- Example URL Structure:
https://id.atlassian.com/profile/view?accountid=**5f8d0c1b2e3f4a5b6c7d8e9f**
Or (for older/alternative Jira Cloud profile views):
https://your-domain.atlassian.net/jira/people/**5f8d0c1b2e3f4a5b6c7d8e9f**
The bolded string (
5f8d0c1b2e3f4a5b6c7d8e9f
in these examples) is your unique Atlassian account ID. - Example URL Structure:
2. Using the Jira REST API (For Developers and Automation)
For developers, administrators, or those looking to automate processes, the Jira REST API provides a programmatic way to retrieve account IDs. This method is particularly useful when you need to fetch account IDs for multiple users or integrate them into scripts.
Steps to Get Account ID via API:
-
Generate an API Token:
- Go to your Atlassian account's API tokens page.
- Click "Create API token", give it a label, and copy the generated token. Keep this token secure.
-
Make an API Request: Use a tool like
cURL
or a REST client (e.g., Postman) to query the Jira API.-
To get your own account ID:
curl --request GET \ --url 'https://your-domain.atlassian.net/rest/api/3/myself' \ --user '[email protected]:YOUR_API_TOKEN' \ --header 'Accept: application/json'
Replace
your-domain.atlassian.net
with your Jira cloud instance URL,[email protected]
with your Atlassian account email, andYOUR_API_TOKEN
with the token you generated. -
To get another user's account ID (requires Jira Admin permissions):
You can search for users by email or display name.curl --request GET \ --url 'https://your-domain.atlassian.net/rest/api/3/user/[email protected]' \ --user '[email protected]:YOUR_API_TOKEN' \ --header 'Accept: application/json'
The response will be a JSON object containing user details, including the
accountId
.
-
API Response Example:
[
{
"self": "https://your-domain.atlassian.net/rest/api/3/user?accountId=5f8d0c1b2e3f4a5b6c7d8e9f",
"accountId": "5f8d0c1b2e3f4a5b6c7d8e9f",
"emailAddress": "[email protected]",
"displayName": "Target User",
// ... other user details
}
]
The value next to "accountId"
is the unique identifier.
3. For Jira Administrators (User Management)
Jira administrators have direct access to user management tools within their Jira instance, which can display account IDs.
Steps for Administrators:
- Access Admin Settings: Log in to Jira and navigate to Jira settings (⚙️ icon) > User management.
- Find the User: Search for the specific user by name or email address.
- View User Details: Click on the user's name. Their account ID is usually displayed prominently on their profile page within the administration console or can be found in the URL similar to the personal profile method.
What is an Atlassian Account ID and Why is it Important?
An Atlassian Account ID is a unique, unchangeable identifier for a user across all Atlassian cloud products. It replaced usernames in many contexts (especially API calls) for several key reasons:
- Persistence: Unlike usernames or email addresses, which can change, the account ID remains constant, ensuring reliable tracking of user data.
- Privacy: It helps in complying with privacy regulations (like GDPR) by decoupling personally identifiable information (PII) from core system identifiers.
- Cross-Product Consistency: It provides a single identifier for a user across Jira, Confluence, Bitbucket, and other Atlassian services.
- Security: It prevents issues like name collision and provides a more robust way to manage permissions and access.
Summary of Methods
Method | Accessibility | Use Case | Output |
---|---|---|---|
Profile URL | All users (personal ID) | Quick look-up for your own ID | Visible in browser URL |
Jira REST API | Developers, Administrators | Automation, bulk look-ups, integrations | JSON response containing accountId |
Jira User Management | Jira Administrators | Finding other users' IDs within the UI | Displayed in user's admin profile page |
By understanding these methods, you can efficiently retrieve the necessary account IDs for managing your Jira instances and integrating with other systems.