Jira
Project Management Installation + User OAuth

Jira

Connect to Jira Cloud for issue tracking and project management via Atlassian OAuth.

Auth Model

Installation + User OAuth

Dual-credential model. An App is first installed into an organization or workspace (yielding an installation credential), then individual users authorize within that installation context (yielding user credentials). Authpipe manages both lifecycles.

Connection Flow

1
Admin installs App
2
Installation credential stored
3
Users authorize
4
User credentials stored
@authpipe/node
// Get the bot/app token (installation-level)
const { credential: botToken } = await authpipe.getCredential({
  provider: 'jira',
  tenantId: 'org_acme',
  credentialFor: 'installation',
});

// Get a user-level token
const { credential } = await authpipe.getCredential({
  provider: 'jira',
  tenantId: 'org_acme',
  userId: 'user_123',
  credentialFor: 'user',
});
// Both credentials are always valid — Authpipe handles refresh
@authpipe/react
// Install the App into a workspace
<InstallButton
  provider="jira"
  onInstall={(inst) => console.log('Installed!', inst)}
/>

Available Scopes

Permissions you can request when connecting to Jira.

read:jira-work

Read Jira project and issue data, worklogs, and attachments

write:jira-work

Create and edit issues, transitions, worklogs, and attachments

read:jira-user

Read Jira user information and avatars

manage:jira-project

Create and edit project settings, components, and versions

manage:jira-configuration

Configure Jira settings including fields, screens, and workflows

manage:jira-data-provider

Manage data provider modules in Jira

manage:jira-webhook

Manage Jira webhooks

read:board-scope:jira-software

Read Jira Software board data

read:sprint:jira-software

Read sprint data in Jira Software

write:board-scope:jira-software

Manage Jira Software boards

read:issue-details:jira

Read issue details including fields, comments, and worklogs

read:project:jira

Read project configuration and details

offline_access

Access data when the user is not present via refresh tokens

read:jira-work

Read Jira project and issue data, worklogs, and attachments

write:jira-work

Create and edit issues, transitions, worklogs, and attachments

read:jira-user

Read Jira user information and avatars

manage:jira-project

Create and edit project settings, components, and versions

manage:jira-configuration

Configure Jira settings including fields, screens, and workflows

offline_access

Access data when the user is not present via refresh tokens

What Authpipe handles for Jira

OAuth Orchestration

PKCE, state validation, callback handling, and provider-specific quirks — all automatic.

Encrypted Vault

AES-256-GCM encryption with per-tenant key isolation. OAuth tokens, API keys, and webhook secrets — never exposed to the frontend.

Silent Refresh

Proactive token refresh before expiry. SDK returns from local cache with zero latency.

Health Monitoring

Scheduled checks detect revoked tokens and expired credentials before users notice.

More Project Management providers

Ready to connect Jira?

Get your first 100 connections free. Set up in minutes with our SDK.