---
title: "Jira Service Management Cloud"
canonical_url: "https://docs.getdx.com/connectors/jira-service-management-cloud/"
md_url: "https://docs.getdx.com/connectors/jira-service-management-cloud.md"
last_updated: "2026-06-08"
---

# Jira Service Management Cloud
By integrating Jira Service Management Cloud (JSM) with DX, you can analyze incident data and metrics such as MTTR and Change Fail Rate, as well as incorporate incident data into DX scorecards. Please refer to the API documentation below and our [schema explorer](https://docs.getdx.com/schema/) to see what data DX imports.

## Prerequisites

To connect JSM to DX, you need:

- a JSM [Managed Account](https://confluence.atlassian.com/cloudkb/profile-visibility-defaults-for-atlassian-accounts-1116292287.html)
- a JSM user account with admin access

## Setup instructions

Follow the steps below to connect JSM to DX:

#### Step 1

Create a Jira service account to be used for DX—the service account must have access to the projects that you want to import.

#### Step 2

**Create a Scoped Token**

- Begin service account creation via [admin.atlassian.com](https://admin.atlassian.com/) under Directory -> Service accounts
- Grant the service account access to the Jira App with the User Role
- When directed, specify the following scopes for the token:
  - **Read:**
    - `read:jira-work`
- Save this token to be used when connecting via DX
- Find your cloud ID to build your base API URL at `https://<my-site-id>/_edge/tenant_info`
  - This should show a hash with a single key value pair that looks like `{"cloudId":"15ace26c-a7e9-49d6-9e1e-5e90906e946e"}`
- Use `https://api.atlassian.com/ex/jira/<cloud-id>` as the base URL
  - eg. `https://api.atlassian.com/ex/jira/15ace26c-a7e9-49d6-9e1e-5e90906e946e`
- For the username, use the generated service account email. It should end in `serviceaccount.atlassian.com`

#### Step 3

Go to **Settings > Issues > Issue Types** and copy the name of the Incident issue type from the list which is associated with Incidents.

#### Step 4

- Navigate to the connections page in DX and select "+ Connection" in the top right.
- Enter the credentials you have generated in the previous steps—refer to the information below for errors and troubleshooting.
  - Your username will be an email address and API token will be a long string beginning with 'ATATT3x'

> **Deprecated Authentication Alternative: Unscoped Token** - To setup a connection, you can also use an [unscoped API Token](https://support.atlassian.com/atlassian-account/docs/manage-api-tokens-for-your-atlassian-account/) created using the **Create API Token** option under **Manage API Tokens** at [id.atlassian.com](https://id.atlassian.com/manage-profile/security/api-tokens). When using an unscoped token, you must use the `<my-id>.atlassian.net` version of your base URL (e.g., `https://my-company.atlassian.net`). We recommend using scoped tokens, but will continue accepting unscoped tokens indefinitely.

## API reference

The table below lists the specific API endpoints that are used by DX.


| Endpoint | Documentation |
|------------------------------------------|---------------|
| /rest/api/3/project | [Link](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-projects/#api-rest-api-3-project-get) |
| /rest/api/3/field | [Link](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-fields/#api-rest-api-2-field-get) |
| /rest/api/3/search | [Link](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-search/#api-rest-api-2-search-jql-post) |


## Errors

The table below lists potential error codes when adding a connection in DX.


| Error | Description |
|----------------------|------------------------------------------------------------------------------------------------------------------|
| `invalid_credentials` | Your API credentials entered are not valid. |
| `invalid_permissions` | Your API token does not have the permissions required by DX. |
| `no_resources` | Your service account does not have access to any projects or repositories. |


## Data Cloud API

Once the initial connection is created successfully, credentials can be managed via the Data Cloud API. This connector uses the same credential fields as [Jira Cloud](https://docs.getdx.com/connectors/jira-cloud/#credential-fields) (`settings.jira_user` and `secrets.api_token`).

- [credentials.create](https://docs.getdx.com/datacloudapi/methods/credentials.create/)
- [credentials.update](https://docs.getdx.com/datacloudapi/methods/credentials.update/)
- [credentials.info](https://docs.getdx.com/datacloudapi/methods/credentials.info/)
- [credentials.list](https://docs.getdx.com/datacloudapi/methods/credentials.list/)
- [credentials.delete](https://docs.getdx.com/datacloudapi/methods/credentials.delete/)
---

## Sitemap

[Overview of all docs pages](/llms.txt)