Skip to main content
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

Create the app

Sign in to the Atlassian Developer Console, then click Create > OAuth 2.0 integration.

  • Enter an App name, for example StackOne Integration.
  • For Access type, select Resource-level, so each linked account connects to the site its user picks.
  • Accept the Atlassian Developer Terms and click Create.
2

Set the callback URL

Click Authorization in the left sidebar, then Add next to OAuth 2.0 (3LO).

  • Enter the Callback URL from your Connector Profile.
  • Click Save changes.
3

Add the classic scopes

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

In the left sidebar, click Permissions. Next to Jira API, click Add, then Configure.

  • On the Classic scopes tab, click Edit Scopes for Jira platform REST API, select each scope listed, and click Save.
4

Add the granular scopes

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

On the Granular scopes tab, click Edit Scopes, select each scope listed, and click Save.

5

Enable sharing

In the left sidebar, click Distribution, then turn on Enable sharing. New apps are private, so until sharing is on, only you can link a Jira account with this app.

  • Vendor name: your company’s name.
  • Privacy policy: a link to your company’s privacy policy.
  • Does your app store personal data?: select Yes or No.
  • Click Save changes.
6

Copy credentials

Click Settings in the left sidebar, then copy the Client ID and Client Secret into your Connector Profile.

  • Click Create a new secret to get the secret. Atlassian only shows it once.

​
Create the StackOne Connector Profile

1

Create a Connector Profile

Enable the connector and create a Connector Profile in your project. See Setup Connector Profile.
2

Link an Account

Once the Connector Profile is created, continue to link an account.