Jira Cloud Integration

Use Jira integration to let Dawn discover projects, read issues and comments, and ground agent workflows in your Jira data.

Before you start

• Your Jira Cloud site URL, usually https://your-org.atlassian.net.
• The Atlassian account email for the Jira user Dawn should use.
• A Jira Cloud API token for that same Atlassian account.
• Permission for that Jira user to browse the projects you want Dawn to discover.

Dawn does not require a Jira Marketplace app install. It connects directly to your Jira Cloud site with your account email and API token.

Jira is also different from Trello. You do not create a Power-Up or app to connect Jira to Dawn. You create a regular Atlassian account API token, then enter your Jira site URL, Atlassian email, and token in Dawn.

Create the API token

1. Sign in to your Atlassian account at id.atlassian.com/manage-profile/security/api-tokens.
2. Open Security and then API tokens.
3. Click Create API token.
4. Name it something like Dawn Jira.
5. Choose the expiry Atlassian requires and create the token.
6. Copy the token immediately. Atlassian will not show the full value again.

Dawn expects a regular Jira Cloud API token for your site URL. Paste only the token value into Dawn. Do not paste email:token, and do not use the separate scoped api.atlassian.com token flow for this integration.

If you do not see the API token option, your Atlassian organization may have disabled token access. Atlassian documents that policy here: Set API token access.

Connect Jira in Dawn

1. Open Integrations in Dawn and click Add connection.
2. Choose Jira.
3. Enter your Jira site URL.
4. Enter the Atlassian account email that owns the token.
5. Paste only the API token value into the token field.
6. Click Connect.
7. Review the discovered Jira projects and link the ones you want available in the workspace.
8. Assign those sources to the agents that should use them.

Dawn prefills the email field from your current Dawn account when it can, but you can edit it if Jira uses a different Atlassian account.

What Dawn discovers

Dawn discovers Jira projects and creates project-scoped issue sources. Each discovered source starts with a default JQL query of project = "KEY" ORDER BY updated DESC.

Troubleshooting

• 401 on validation: make sure the email and token belong to the same Atlassian account, and paste only the token value into the token field.
• Used the Trello or Bitbucket flow by mistake: for Jira, create a regular Atlassian account API token, not a Trello app key and not a Bitbucket email:token combined credential.
• Project not visible: the Jira user behind the token probably lacks project browse permission.
• No token option in Atlassian: your organization may have disabled API token access.
• Issue search still fails after connection succeeds: rerun a simple project query first, then contact support if reads consistently fail.

List linked Jira projects and confirm issue/comment retrieval works.

Show authentication status for Jira Cloud connection.