Skip to main content
Select Actions to adjust the guide
Some actions may require additional configuration in the provider to be accessible. Choose the actions you need and the guide will be updated.
Action
Scope(s)
Loading actions…
Dynamic Guide URL
Scopes Selected
Separator
You will need administrator access to your Atlassian account to create and manage OAuth 2.0 apps in the Developer Console.


​
Create an OAuth 2.0 app
Register a new OAuth 2.0 integration in the Atlassian Developer Console.
1
Sign in to Atlassian
Sign in to the Atlassian Developer Console.
  • Click Create in the top-right corner.
  • Select OAuth 2.0 integration.
2
Create a new app
Fill in the application details.
  • Enter an App name (e.g., “StackOne JSM Integration”).
  • Accept the Atlassian Developer Terms.
  • Click Create.
3
Add callback URL
In your app settings, click Authorization in the left sidebar.
  • Click Add next to “OAuth 2.0 (3LO)”.
  • Enter the callback URL: https://api.stackone.com/connect/oauth2/jiraservicemanagement/callback
  • Click Save changes.
4
Set permissions
Click Permissions in the left sidebar. You will need to add permissions for both Jira API and Jira Service Management.
5
Add Jira platform permissions
Click Add next to Jira API then click Configure. On the Classic scopes tab, click Jira platform REST API > Edit Scopes then enable the following required scopes.
  • Required: Select View user information in Jira (read:jira-user)
  • Required: Select Read Jira project and issue data (read:jira-work) — needed for queues
  • Click Save to confirm the scopes.
6
Add Jira Service Management classic scopes
Enables actions: Add Customers To Service Desk, Add Organization To Service Desk, Add Request Participants, Add Users To Organization, Create Customer, Create Organization, Create Request, Create Request Comment, Delete Organization, Delete Request Feedback, Get Organization, Get Request, Get Request Comment, Get Request Feedback, Get Request Status, Get Request Type, Get Request Type Fields, Get Service Desk, List All Organizations (Global), List All Request Types (Global), List Customer Requests, List Organization Users, List Organizations For Service Desk, List Request Approvals, List Request Comments, List Request Participants, List Request Transitions, List Request Type Groups, List Request Types For Service Desk, List Service Desk Customers, List Service Desks, Post Request Feedback, Remove Organization From Service Desk, Remove Request Participants, Remove Users From Organization
Click Add next to Jira Service Management then click Configure. On the Classic scopes tab, click Edit Scopes then enable the following required scopes.
  • Required: Select Read Jira Service Management request data (read:servicedesk-request)
  • Required: Select Write Jira Service Management request data (write:servicedesk-request)
  • Required: Select Manage Jira Service Management customers (manage:servicedesk-customer)
  • Click Save to confirm the scopes.
7
Add Jira Service Management granular scopes
Enables actions: Get Queue, Get SLA Metric By ID, List All SLA Metrics, List Queue Issues, List Queues, Perform Request Transition
On the Granular scopes tab, click Edit Scopes then enable the following required scopes.
  • Required: Select View queues (read:queue:jira-service-management)
  • Required: Select View request SLAs (read:request.sla:jira-service-management)
  • Required: Select Execute request transitions (write:request.status:jira-service-management)
  • Click Save to confirm the scopes.
8
Copy client credentials
Click Settings in the left sidebar.
  • Copy the Client ID displayed at the top.
  • Click Create a new secret under Authentication details.
  • Copy the Client Secret immediately and store securely — it is only shown once.


​
Creating the StackOne Connector Profile

To create the Connector Profile in StackOne for Jira Service Management:

1
Navigate to Connector Profiles
Login to StackOne and navigate to Connector Profiles
2
Create New Connector Profile
  • Click + Connector Profile
  • Search for and select Jira Service Management
  • Select Type as OAuth 2.0
  • Fill out the fields using details retrieved from your provider:
    • Client ID
    • Client Secret
    • OAuth Scopes (Optional)
  • (Optional) Select Actions to be enabled for this Connector Profile
  • Click Create profile

Congratulations! The new Connector Profile will now show up in your project ready to be used. You can now continue to Link Accounts for Jira Service Management.