Integrations : SaaS : Atlassian
Adding the Atlassian Integration and Its Associated Insights
Overview
The Atlassian connection in Block 64 enables secure, read-only access to data from Atlassian tools such as Jira and Confluence.
This integration collects information about projects, issues, workflows, and documentation, supporting visibility into development processes and team collaboration.
Once connected, the data collected from this integration appears in the following Block 64 Insights reports:
-
Reports → SaaS → Usage – Displays usage and adoption of Atlassian products across the organization.
-
Reports → SaaS → Licensing – Shows license allocation and usage metrics for Atlassian tools.
-
Reports → SaaS → Productivity – Provides visibility into projects, issues, and collaboration trends.
The credentials needed for this Integration
To set up this integration, you’ll need the following from your Atlassian admin console:
-
Organization ID – Unique identifier for your Atlassian organization.
-
Unscoped API Key – API key created with permission scopes that allow access to all required API endpoints for Jira, Confluence, and other Atlassian services.
Create an Unscoped API Key (Atlassian Cloud)
To create an API key without scopes:
- Go to admin.atlassian.com. Select your organization if you have more than one.
- Select Settings > API keys.
- Select Create API key.
- Select API keys without scopes.
- Select Create API key.
- Review your API key scope information.
- Select Create to save the API key.
- Copy your API key and save it somewhere safe. You can't recover the API key later. As a security precaution, Atlassian doesn't store your API key value.
For additional information on Atlassian API configuration and usage, refer to the official Atlassian documentation.
Find your Organization ID
-
In admin.atlassian.com, open your org and copy the ID from the URL:
https://admin.atlassian.com/o/<ORG_ID>
-
Or go to Settings → Organization details and copy Organization ID.
If you don’t see API keys or the Unscoped option, verify you’re an Organization Admin or check with your Atlassian admin to enable Org API keys.
How to add this Integration
-
In the Block 64 Insights portal, navigate to Integrations.
-
Select Atlassian and click Connect.
-
Enter the following information:
-
Organization ID – Found in your Atlassian admin console.
-
Unscoped API Key – Generated in Atlassian with the required permission scopes for all API endpoints.
-
-
Click Connect to finalize setup.
Why is this Integration failing?
If the integration isn’t working, it’s usually caused by:
-
Invalid credentials – The Organization ID or API Key entered may be incorrect.
-
Expired or revoked API Key – The API Key may have been regenerated in Atlassian without updating it in Block 64.
-
Insufficient permission scopes – The API Key must be unscoped and include all required endpoints; scoped or restricted keys may block data collection.
To fix this:
-
Double-check that the Organization ID matches the value in your Atlassian admin console.
-
Verify that the API Key is unscoped and has the necessary permission scopes.
-
If you regenerate the API Key, update it in Block 64 immediately.
How to remove this Integration
From Block 64:
You can disable this integration temporarily by clicking on the Enable switch in the integration.
Alternatively, you can disconnect the integration entirely by clicking on the Disconnect button.
From Atlassian:
-
Sign in to your Atlassian admin console.
-
Navigate to the API Keys section.
-
Revoke or delete the API Key created for Block 64.