Jira Cloud as your first Atlassian integration

📘

Important

This guide walks you through how to set up Jira Cloud if you haven't already connected to Jira Core Cloud, Jira Software Cloud, Jira Service Desk Cloud, or Confluence Cloud.

If you have already connected with any of those apps, please see: Jira Cloud as an additional Atlassian integration.

Jira's Guide: https://developer.atlassian.com/cloud/jira/platform/rest/v3/
Authorization protocol: OAuth 2.0

1. Add the Jira Cloud connector in the Xkit platform.

• In the Xkit platform, click "New connector" in the sidebar or at the bottom of the "Connectors" screen.
• Click "Jira Cloud". At this point you'll see a callback URL, which you'll provide to Jira Cloud in one of the following steps, and places to input the Client ID and Client Secret that you'll get from Jira Cloud after registering your app with them.

2. Register your application with Jira Cloud.

• Next, in a separate window, sign in to your Jira/Atlassian account or create an account if you don't have one.
• Visit this link: https://developer.atlassian.com/apps/
• Click "Create new app". Enter the name of your application, check the box to agree to the terms, and click "Create".

3. Provide Xkit with the credentials.

• After completing the last step, you should have been taken to a screen that shows your Client ID and Secret.
• Copy/paste your Client ID and Secret onto the Xkit page.
• If you like, you can also enter a description of your app and your logo on this page.

4. Provide Jira Cloud with the callback url.

• Click "OAuth 2.0 (3LO)" in the sidebar.
• Copy/paste the callback URL from the Xkit platform into the "Callback URL" field on the Jira Cloud page.
• Click "Save changes".

5. Add the Jira Cloud API.

• After saving changes in the last step, you will see a message that says "Your app doesn't have any APIs. Add APIs to your app." Click the "Add APIs" link.
• Under "Jira platform REST API", click "Add".

6. Select the required permissions.

• Again under "Jira platform REST API", click "Configure".
• Click "Add" next to your required scopes (additional details about the scopes are available in the OAuth2 section of this page).

7. Complete the Xkit connection setup.

• Now that you've provided the callback URL to Jira Cloud and entered the Client ID and Client Secret into the Xkit platform, click "Save" on the Xkit page.
• Fill out the Catalog Settings page and again click "Save".
• On the next page, select the same permissions/scopes you entered into Jira Cloud and click "Save".

You've now successfully connected Jira Cloud with Xkit!