Steps
-
Log in to the Atlassian Developer Console
- Go to https://developer.atlassian.com/console/myapps/
- Sign in with your Jira/Atlassian account (sign up free if needed)
-
Create a New OAuth 2.0 App
- On the dashboard, click Create App
- Select OAuth 2.0 (3LO)
- Enter an App Name (e.g.,
My Jira Integration)
-
Configure the Redirect URL
- Add your OAuth callback URL in the redirect URL field
-
Configure Permissions (Scopes)
- Select the scopes your integration requires. Common Jira scopes:
read:jira-user— Read user dataread:jira-work— Read issues, projects, boardswrite:jira-work— Create/update issuesmanage:jira-project— Manage project settingsmanage:jira-configuration— Manage Jira configurationoffline_access— Refresh tokens
- Additional scopes:
read:sprint:jira-software,write:sprint:jira-software,read:board-scope:jira-software,read:project:jira,read:issue-type-scheme:jira - Click Save
- Select the scopes your integration requires. Common Jira scopes:
-
Retrieve OAuth Credentials
- Go to the Settings page of your app
- Copy the Client ID and Client Secret
- Store the secret securely
Key Details
- Developer Console: https://developer.atlassian.com/console/myapps/
- Auth Type: OAuth 2.0 (3LO)
- Token URL:
https://auth.atlassian.com/oauth/token - Authorization URL:
https://auth.atlassian.com/authorize - Base API URL:
https://api.atlassian.com/ex/jira/{cloudId}- Replace
{cloudId}with your Jira Cloud site ID (found in the Developer Console)
- Replace
- Credentials Location: App → Settings → Client ID & Client Secret