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 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/<organization-id>).
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/<organization-id>) 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.