Jira Service Desk Cloud as your first Atlassian integration

Steps to set up Jira Service Desk Cloud with Xkit if you haven't connected to any Jira apps or Confluence before



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

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

Jira's Guide: https://developer.atlassian.com/cloud/jira/service-desk/rest/
Authorization protocol: OAuth 2.0

1. Add the Jira Service Desk 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 Service Desk Cloud". At this point you'll see a callback URL, which you'll provide to Jira Service Desk Cloud in one of the following steps, and places to input the Client ID and Client Secret that you'll get from Jira Service Desk Cloud after registering your app with them.

2. Register your application with Jira Service Desk 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 Service Desk 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 Service Desk Cloud page.
  • Click "Save changes".

5. Add the Jira Service Desk Cloud and Jira platform REST APIs.

  • 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 Service Desk API", click "Add".
  • Jira Service Desk also requires some permissions from the Jira platform API. Therefore, also add this by clicking "Add" under "Jira platform REST API".

6. Select the required permissions.

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

7. Complete the Xkit connection setup.

  • Now that you've provided the callback URL to Jira Service Desk 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 Service Desk Cloud and click "Save".

You've now successfully connected Jira Service Desk Cloud with Xkit!