Skip to content
Jira Service Management Spoke › Integration Hub spokes › Build integrations › Integration Hub › Workflow Data Fabric
Release: Australia · Updated: 2026-03-12 · Official documentation · View source

Set up the Jira Service Management spoke

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.

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 for more information.

Generate an Atlassian account API token

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 portal documentation for instructions on generating your API token.

Note: This procedure is applicable only if you are using the Jira Cloud subscription.

Procedure

  1. Log in to Atlassian Start as an admin.

  2. Go to your account profile photo and select Account Settings.

Image omitted: jira-basic-settings.png
Atlassian Start page with the drop down menu of the selected profile picture. Account Settings option emphasized.

  1. Go to Security.

  2. In the API token section, select Create and manage API tokens.

  3. Click Create API token.

  4. On the form, provide an integration name for the Label field.

  5. Click Create.

Image omitted: jira-token.png
The Create an API token modal with the Create button emphasized.
The API token is generated.
  1. Click Copy and record the value of the API token for later use.
Image omitted: jira-api-token.png
Confirmation modal of Your new API token with the Copy button emphasized.

What to do next

Use your API token to configure the cloud connection for the Jira spoke.

Configure a connection for the Jira Service Management spoke

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 All > Process Automation > Workflow 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. If you are configuring the spoke for the first time, click Configure. Otherwise, click Edit.

  5. On the Connection form, fill in the fields.

FieldDescription
Connection NameName to uniquely identify the connection. For example, `Jira Spoke OAuth basic conn`.
Connection URLURL of your Jira instance in this format: `https://api.atlassian.com/ex/jira/{cloud-id}/`. Replace `{cloud-id}` with value of the Cloud ID you had obtained previously.
ScopesBy default, these scopes are provided read:jira-user, read:servicedesk-request, write:servicedesk-request, manage:servicedesk-customer, read:jira-work, read:me, read:account, offline_access. 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.
Image omitted: jira-sm-conn-temp.jpg
6. Click **Save and Get OAuth Token**.