Skip to main content
Connect your Atlassian Jira Cloud account to Adapt using an API token with Basic authentication.

​
Set up credentials

1

Open the Atlassian API token page

Sign in to your Atlassian account, then go to https://id.atlassian.com/manage-profile/security/api-tokens.
2

Create an API token

Click Create API token, give it a descriptive name, set an expiration date, then click Create.
3

Copy the token

Click Copy to clipboard and store the token somewhere safe. Atlassian shows it only once.
4

Note your email and site domain

Record the email address of your Atlassian account and your Jira site domain, for example your-company.atlassian.net.
Jira authenticates with HTTP Basic auth using your account email as the username and the API token as the password.

​
Connect to Adapt

1

Open Integrations

In Adapt, go to Settings > Integrations.
2

Find Jira

Search for Jira and select it from the catalog.
3

Start the connection

Click Connect to open the connection form.
4

Add your credentials

Enter the values you gathered above, then click Add connection:
Secret NameValue
JIRA_API_TOKENYour Atlassian API token
JIRA_EMAILThe email of your Atlassian account
JIRA_DOMAINYour Jira site domain, e.g. your-company.atlassian.net
You can rename the connection and choose whether it is shared with your organization or kept personal to you.
5

Test the connection

Ask Adapt to list your projects.

​
Security

  • Credentials are encrypted at rest with AES-256
  • The token inherits your Jira permissions, so it can access only the projects and issues you can see
  • Set an expiration date and revoke tokens anytime from your Atlassian account API token page
  • Do not share or commit your API token

​
Capabilities

Adapt can read your Jira Cloud site to analyze issues, sprints, projects, and workflows. Use it to track progress, surface blockers, and review team throughput.

​
Examples

Summarize open issues in the PLATFORM project by status.

What is in the current sprint and who owns each issue?

List all high-priority bugs assigned to me.

Show how issues are moving through the workflow this week.