Atlassian OAuth2 Credentials for n8n

This package provides OAuth2 authentication for Atlassian services (Jira, Confluence, etc.) in n8n workflows.

Features

• OAuth2 Authorization Code flow implementation
• Support for Atlassian Cloud services
• Automatic token refresh
• Comprehensive scope support for Jira operations

Setup

1. Create an Atlassian OAuth2 App:

   • Go to Atlassian Developer Console
   • Create a new OAuth 2.0 (3LO) app
   • Note your Client ID and Client Secret
   • Set the redirect URL to your n8n instance: https://your-n8n-instance.com/rest/oauth2-credential/callback

2. Install the credential:

   • Copy AtlassianOAuth2Api.credentials.ts to your n8n custom credentials directory
   • Restart n8n

3. Configure the credential:

   • In n8n, create a new credential of type "Atlassian OAuth2 API"
   • Enter your Client ID and Client Secret
   • Click "Connect my account" to authorize

Scopes

The credential includes these scopes by default:

• read:jira-user - Read user information
• read:jira-work - Read Jira issues and projects
• write:jira-work - Create and update Jira issues
• manage:jira-project - Manage Jira projects
• manage:jira-configuration - Manage Jira configuration

Usage

Once configured, use this credential with HTTP Request nodes to call Atlassian APIs:

GET https://api.atlassian.com/oauth/token/accessible-resources
GET https://api.atlassian.com/ex/jira/{cloudId}/rest/api/3/myself

Troubleshooting

• Ensure your redirect URL matches exactly what's configured in Atlassian
• Check that all required scopes are granted during authorization
• Verify your Atlassian app has the necessary permissions