---
sourceDocument: Australia Workflow Data Fabric
sourceDocumentLink: https://www.servicenow.com/docs/r/australia/integrate-applications

 Release :

    - australia

ft:locale :

    - en-US

ft:publication_title :

    - Australia Workflow Data Fabric

ft:clusterId :

    - crint

bundleId :

    - crint

workflow :

    - Creator


---

# Set up the Jira Service Management spoke

# Set up the Jira Service Management spoke {#ariaid-title1}

Release version: Australia  
Updated March 12, 2026  
![](https://www.servicenow.com/docs/portal-asset/ico-clock) 4 minutes to read  
Integrate the ServiceNow instance and Jira Service Management by using OAuth 2.0 to authenticate ServiceNow requests.

## Before you begin

* Request an Integration Hub subscription.
* Activate the Jira Service Management spoke.
* Role required: admin.
{#setup-jira-serv-mgmt__ul_agy_qxd_rlb}

## About this task

Important:  
Starting with the Australia release, instructions for generating and using API tokens have been removed from our documentation to align with Atlassian's Acceptable Use Policy. See the Atlassian blog, [Building Secure and Scalable Integrations: Our Guidance for Third-Party Apps](https://www.atlassian.com/blog/developer/building-secure-and-scalable-integrations-our-guidance-for-third-party-apps) for more information.

## Option 1: Using OAuth authentication {#ariaid-title2}

Integrate the ServiceNow instance with your Jira Service Management account using OAuth to authenticate ServiceNow requests.

### Before you begin

Role required: admin

### Obtain the value of Cloud ID {#ariaid-title3}

Obtain the value of Cloud ID of the cloud instance. This value is required during the configuration of the connection record in your ServiceNow instance.

#### Before you begin

Role required: admin

#### Procedure

1. Log in to [Atlassian Administration](https://admin.atlassian.com/) as an admin.
2. Click Select against the required organization.
3. From the Jira Software product, click Manage product access.  
   A new window is opened and the URL is in this format: <kbd class="ph userinput">https://admin.atlassian.com/s/&lt;Cloud-ID&gt;/apps</kbd>.
4. Copy the value of the Cloud ID for later use.

### Configure a connection for the Jira Service Management spoke {#ariaid-title4}

Add and configure a Jira Service Management connection to authenticate ServiceNow requests in a Jira Service Management spoke.

#### Before you begin

Role required: admin

#### Procedure

1. Navigate to AllProcess AutomationWorkflow Studio.
2. Click the Integrations tab.
3. Under Connections, the Outbound connections are displayed by default.
4. Locate the Jira_SM connection alias and click View Details.  
   * To configure the default connection and credential alias record that is shipped along with the Jira Service Management spoke, click View Details.
   * To manage more than one Jira Service Management spoke connection records, you should create a new child alias record by clicking Add Connection. For more information about using multiple connections, see [Supporting multiple connections](https://www.servicenow.com/docs/_lq_yIU58hH6WV7QrgzfAg "Support several connections to a single integration provider. Select connections for flows, subflows, and actions directly from a flow.").

   {#jira-sm-basic-conf-temp__ul_p54_wrr_qwb}If you are configuring the spoke for the first time, click Configure. Otherwise, click Edit.
5. On the Connection form, fill in the fields.  
   {#jira-sm-basic-conf-temp__table_tfv_3d5_h5b__entry__2}

   | Field | Description |
   |-|-|
   | Connection Name | Name to uniquely identify the connection. For example, <kbd class="ph userinput">Jira Spoke OAuth basic conn</kbd>. |
   | Connection URL | URL of your Jira instance in this format: <kbd class="ph userinput">https://api.atlassian.com/ex/jira/{cloud-id}/</kbd>. Replace <kbd class="ph userinput">{cloud-id}</kbd> with value of the Cloud ID you had obtained previously. |
   | Scopes | By default, these scopes are provided <kbd class="ph userinput">read:jira-user, read:servicedesk-request, write:servicedesk-request, manage:servicedesk-customer, read:jira-work, read:me, read:account, offline_access</kbd>. You can modify the scopes as per your requirement. Note: After the scopes are modified and saved, whenever you edit the connection record, the scopes are reset to the default scopes. |
   [ ]

   {#jira-sm-basic-conf-temp__table_tfv_3d5_h5b}

6. Click Save and Get OAuth Token.
{#jira-sm-basic-conf-temp__steps_kk1_4bz_t3c}

## Option 2: Using Atlassian API token {#ariaid-title5}

Integrate the ServiceNow instance and Jira Service Management by using the Basic Auth credentials to authenticate ServiceNow requests.

### Before you begin

Important:  
Apps that collect or store API tokens don't comply with Atlassian security requirements for cloud apps and Atlassian acceptable use policy.

Role required: admin

### Generate an Atlassian account API token {#ariaid-title6}

Generate an Atlassian account API token to authenticate requests for spokes associated with an Atlassian account.

#### Before you begin

Make sure you have an Atlassian account.

Role required: Atlassian administrator credentials

#### About this task

Complete these steps from your Atlassian account. See the [Atlassian Developer](https://developer.atlassian.com/docs/) portal documentation for instructions on generating your API token.  
Note:  
This procedure is applicable only if you're using the Jira Cloud subscription.

#### Procedure

1. Log in to [Atlassian Start](https://start.atlassian.com/) as an admin.
2. Go to your account profile photo and select Account Settings.  
3. Go to Security.
4. In the API token section, select Create and manage API tokens.
5. Select API token.
6. On the form, provide an integration name for the Label field.
7. Select Create.  
   The API token is generated.
8. Select Copy and record the value of the API token for later use.  
{#generate-jiratokenv302__steps_j3p_ndz_4fb}

#### What to do next

Use your API token to configure the cloud connection for a Jira or Jira Service Management spoke.

### Create credential record for the Jira Service Management spoke {#ariaid-title7}

Create a credential record for the Jira account. The Jira Service Management spoke connection and credential alias uses this credential to authorize actions.

#### Before you begin

Role required: admin

#### Procedure

1. Navigate to AllConnections \& CredentialsCredentials.
2. Click New.  
   The system displays the message What type of Credentials would you like to create?
3. Select Basic Auth Credentials.
4. On the form, fill these values.  
   {#jira-sm-opt2-cred__table_pcs_vps_gwb__entry__2}

   | Field | Description |
   |-|-|
   | Name | Name to identify the credential record for the Jira Service Management spoke. For example, <kbd class="ph userinput">Jira SM Basic Auth Token cred</kbd>. |
   | User name | Enter the email address of the user. |
   | Password | Enter the API token you generated for your Jira Cloud instance. |
   [ ]

   {#jira-sm-opt2-cred__table_pcs_vps_gwb}
5. Right-click the form header and click Save.
{#jira-sm-opt2-cred__steps_ui0_nf78t_53c}

### Create a connection record for the Jira Service Management spoke {#ariaid-title8}

Create a connection record for the Jira account. The connection and credential alias uses this connection to perform actions in Jira Service Management.

#### Before you begin

Role required: admin

#### Procedure

1. Navigate to AllConnections \& CredentialsConnection \& Credential Aliases.
2. Open the alias record Jira_SM that shipped with the spoke.
3. On the Connections tab, click New.  
   The system displays a blank HTTP(s) Connection form.
4. Enter these values and click Submit.  
   {#jira-sm-opt2-conn__table_vsw_lkv_4fb__entry__2}

   | Field | Value required |
   |-|-|
   | Name | Enter any name to uniquely identify the connection record. For example, enter <kbd class="ph userinput">Jira cloud Basic Auth Token Connection</kbd>. |
   | Credential | Select the Credential record created for Jira. For example, select Jira SM Basic Auth Token cred. |
   | Connection URL | Enter the URL of your Jira instance in this format: <kbd class="ph userinput">https://&lt;provider-domain-name&gt;.atlassian.net</kbd>. |
   [ ]

   {#jira-sm-opt2-conn__table_vsw_lkv_4fb}
5. Click Submit.  
   The Jira Service Management spoke is configured to use basic credentials via the service account.
{#jira-sm-opt2-conn__steps_ahq_ggt_53c}

*[\>]: and then