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 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/jira/callback
  • Click Save changes.
4
Set permissions
Click Permissions in the left sidebar.
  • Click Add next to Jira API then click Configure.
  • Enable permissions for your use case in the steps below.
5
Add Jira API permissions
Enables actions: Add Attachment, Archive Project, Assign Issue, Copy Dashboard, Create Component, Create Dashboard, Create Filter, Create Group, Create Group Member, Create Issue, Create Issue Comment, Create Issue Link, Create Issue Link Type, Create Issue Vote, Create Issue Watcher, Create Issue Worklog, Create Project, Create Project Category, Create Project Role, Create Project Role Actor, Create Remote Issue Link, Create Version, Delete Attachment, Delete Comment, Delete Component, Delete Dashboard, Delete Filter, Delete Filter Favourite, Delete Group, Delete Group Member, Delete Issue, Delete Issue Link, Delete Issue Link Type, Delete Issue Vote, Delete Issue Watcher, Delete Issue Worklog, Delete Project, Delete Project Category, Delete Project Role, Delete Remote Issue Link, Delete Remote Issue Link By Global ID, Delete Version, Get All Permissions, Get All Users, Get Attachment, Get Attachment Archive Metadata, Get Attachment Settings, Get Bulk Permissions, Get Changelogs By IDs, Get Comment, Get Component, Get Current User, Get Dashboard, Get Favourite Filters, Get Field Configurations, Get Filter, Get Group Members, Get Issue, Get Issue Changelogs, Get Issue Link, Get Issue Link Type, Get Issue Link Types, Get Issue Transitions, Get Issue Type, Get Issue Worklog, Get My Filters, Get My Permissions, Get Priority, Get Project, Get Project Category, Get Project Components, Get Project Issue Types, Get Project Role, Get Project Role For Project, Get Project Statuses, Get Project Versions, Get Remote Issue Link, Get Resolution, Get Server Info, Get Status, Get Unified Credentials, Get Unified Group, Get Unified Role, Get Unified User, Get User, Get User Groups, Get Version, Get Workflow Scheme, List Components, List Dashboards, List Fields, List Filters, List Groups, List Issue Comments, List Issue Types, List Issue Votes, List Issue Watchers, List Issue Worklogs, List Labels, List Priorities, List Project Categories, List Project Roles, List Projects, List Remote Issue Links, List Resolutions, List Statuses, List Unified Groups, List Unified Roles, List Unified Users, List Workflow Schemes, Restore Deleted Project, Search Dashboards, Search Fields, Search For Issues Using JQL, Search Groups, Search Users, Search Users Assignable To Issues, Search Users Assignable To Projects, Search Users For Picker, Search Users With Browse Permission, Search Users With Permissions, Search Workflows, Set Filter Favourite, Transition Issue, Update Comment, Update Component, Update Dashboard, Update Filter, Update Issue, Update Issue Link Type, Update Issue Worklog, Update Project, Update Project Category, Update Remote Issue Link, Update Version
On the Classic scopes tab, click Jira platform REST API > Edit Scopes then enable the following required scopes. Important: The read:jira-work scope is mandatory for successful account connection — the connection will fail without it.
  • Required: Select View user information in Jira (read:jira-user)
  • Required for connection: Select Read data from Jira (read:jira-work) — this scope is mandatory for account connection to succeed
  • Required: Select Write data to Jira (write:jira-work)
  • Required: Select Administer Jira projects (manage:jira-project)
  • Required: Select Administer Jira (manage:jira-configuration)
  • Click Save to confirm the scopes. Verify that all five scopes are enabled: read:jira-user, read:jira-work, write:jira-work, manage:jira-project, manage:jira-configuration.
6
Add Jira Software permissions
Enables actions: Create Sprint, Delete Sprint, Get All Boards, Get Board, Get Board Backlog, Get Board Configuration, Get Board Issues, Get Board Sprints, Get Sprint, Get Sprint Issues, Move Issues To Sprint, Partially Update Sprint
Click Add next to Jira Software then click Configure. On the Granular scopes tab, click Edit Scopes then enable the following required scopes:
  • Required: Select View board data in Jira Software (read:board-scope:jira-software)
  • Required: Select View sprint data in Jira Software (read:sprint:jira-software)
  • Required: Select Update sprint data in Jira Software (write:sprint:jira-software)
  • Required: Select Delete sprint data in Jira Software (delete:sprint:jira-software)
  • Click Save to confirm the scopes. Verify that all four scopes are enabled: read:board-scope:jira-software, read:sprint:jira-software, write:sprint:jira-software, delete:sprint:jira-software.
7
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:

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
  • 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.