Balsa supports all versions of Jira, including Jira Cloud, Jira Server, and Jira Data Center.
To sync with Jira, you'll need to follow different steps depending on which version of Jira your company uses. Instructions for each version are below. If you have questions or run into trouble, email us at firstname.lastname@example.org. We're happy to help!
Figuring out which version of Jira you're using
The easiest way to do this is to load your organization's Jira instance, and look at the URL in your browser's navigation bar.
- If your Jira URL starts with
https://<name>.atlassian.netyou're using Jira Cloud. Continue below in the "Signing into Jira Cloud" section.
- If it starts with anything else, like the domain of your company's intranet, you're using on-premise Jira (either Jira Server or Jira Data Center). Skip down to the "Signing into on-premise Jira" section.
Signing into Jira Cloud
To sync with Jira Cloud, you'll need an API token. To create one, you can jump directly to Atlassian's API Tokens page here: https://id.atlassian.com/manage-profile/security/api-tokens.
1️⃣ Click the blue "Create API token" button in the top right corner.
2️⃣ Type a name for this key. We recommend something easily identifiable, like "Balsa Build".
3️⃣ Click the blue "Create" button. This will create your API token.
4️⃣ Click the blue "Copy" button. The API token will now be in your clipboard.
5️⃣ Paste the API token into Balsa Build.
6️⃣ Once you're done, click the gray "Close" button. You can now close this tab.
Signing into on-premise Jira
To sync with on-premise Jira, Balsa Build uses the same authentication flow you already use to log into your organization's Jira. Once you've entered your Jira URL into Balsa Build, you'll be taken to the same login screen you usually use, and when you log in, syncing should start automatically.