> ## Documentation Index > Fetch the complete documentation index at: https://docs.stackone.com/llms.txt > Use this file to discover all available pages before exploring further. # Jira OAuth 2.0 connector profile – StackOne setup guide > Set up the OAuth 2.0 connector profile for Jira in StackOne. One-time admin setup required before your users can link Jira accounts via Hub. You will need administrator access to your Atlassian account to create and manage OAuth 2.0 apps in the Developer Console.
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

Create an OAuth 2.0 app

Register a new OAuth 2.0 integration in the Atlassian Developer Console.

Sign in to the Atlassian Developer Console.

  • Click Create in the top-right corner.
  • Select OAuth 2.0 integration.

Fill in the application details.

  • Enter an App name (e.g., "StackOne Integration").
  • Accept the Atlassian Developer Terms.
  • Click Create.

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.

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

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: Login to StackOne and navigate to [Connector Profiles](https://app.stackone.com/connector_profiles)
  • 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.