> For the complete documentation index, see [llms.txt](https://docs.harmony.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.harmony.io/integrations/saas-applications/atlassian-admin-api.md). # Atlassian (Admin API) The Atlassian Admin API integration connects your Atlassian organization directly to Harmony, giving you richer visibility into how your team uses Atlassian products - without relying on a third-party connector. Once connected, Harmony surfaces license and user data across your entire Atlassian workspace, helping you understand adoption, manage access, and make informed decisions about your Atlassian spend. ### What data is synced When you connect your Atlassian organization, Harmony collects the following data: * **License types per product** - see which users are licensed for Jira Software, Jira Service Management, Jira Customer Service, Confluence, Bitbucket, CMDB, and Rovo, along with their exact plan tier (Free, Standard, Premium, or Enterprise) * **User directory** - a complete view of every user across all Atlassian products in your organization ### Prerequisites Before you connect, make sure you have: * An active Atlassian organization with admin access * Organization Admin or Super Admin permissions in Atlassian Admin (`admin.atlassian.com`) * The ability to create and manage API keys in your Atlassian organization ### Connecting Atlassian to Harmony Follow these steps to set up the direct integration: 1. Sign in to [Atlassian Admin](https://admin.atlassian.com) and select your organization. 2. Navigate to **Settings** and open the **API keys** section. 3. Click **Create API key**, give it a descriptive name (for example, `Harmony Integration`), and set an appropriate expiry date. 4. Copy the generated API key - you will not be able to view it again after leaving the page. 5. Note your **Organization ID**, which appears in the URL of your Atlassian Admin dashboard (`admin.atlassian.com/o/`). 6. In Harmony, go to **Integrations** and select **Atlassian Admin API** from the SaaS Applications list. 7. Click **Connect** and enter your **Organization ID** and **API key** when prompted. 8. Click **Save** to complete the connection. Harmony will begin syncing data from your Atlassian organization. The initial sync may take a few minutes depending on the size of your user directory. ### Permissions required The API key used for this integration must belong to a user with **Organization Admin** or **Super Admin** privileges in Atlassian Admin. Without these permissions, Harmony will not be able to retrieve license or user directory data. ### Data refresh After the initial sync, Harmony automatically refreshes your Atlassian data on a regular schedule. You can also trigger a manual sync at any time from the integration settings page in Harmony. ### Disconnecting the integration To remove the Atlassian Admin API integration: 1. In Harmony, go to **Integrations** and find the Atlassian Admin API connection. 2. Click **Disconnect** and confirm your choice. 3. Optionally, revoke the API key in Atlassian Admin to ensure it can no longer be used. Disconnecting the integration stops all future data syncs. Historical data already collected in Harmony is retained according to your workspace data retention settings. ### Troubleshooting **Sync fails immediately after connecting** Verify that the API key belongs to a user with Organization Admin or Super Admin permissions. Keys created by users with lower privilege levels will not have access to the required endpoints. **Organization ID not accepted** Make sure you are copying the Organization ID from the URL in Atlassian Admin (`admin.atlassian.com/o/`) and not a site-level identifier. **API key expired** Atlassian API keys have an expiry date set at creation time. If your key has expired, generate a new one in Atlassian Admin and update the credentials in Harmony under **Integrations** - **Atlassian Admin API** - **Edit**. **Only partial product data is visible** Harmony surfaces data for the products active in your Atlassian organization. If a product does not appear, confirm it is provisioned and has active licenses within your organization. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.harmony.io/integrations/saas-applications/atlassian-admin-api.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.