Skip to main content

Jira

Jira is a project management and issue tracking tool used for software development, task management, and agile project management.

Authentication Types​

Jira (Cloud) supports 3 authentication methods:

  • OAuth - Create your own Atlassian OAuth app with custom scopes. Every user connects with their Atlassian account.

    • Pros: Full control, per-user tracking, production-ready
    • Cons: ~2 min setup

  • Instant OAuth - Use Willow's pre-configured Jira app for the fastest setup.

    • Pros: Fastest setup, no configuration needed
    • Cons: Limited scopes, not recommended for production

  • API Key - Use your Atlassian email and API token for authentication.

    • Pros: Easy setup
    • Cons: Single credential for all users

Configuration​

Before using the connector, you need to configure:

  • Jira Organization Domain - Your Jira instance domain (e.g., yourcompany.atlassian.net)

Setting up OAuth​

  1. Go to https://developer.atlassian.com/console/myapps/
  1. Click Create → OAuth 2.0 integration
  1. Enter a name for your app and click Create

  1. In the left sidebar, go to Permissions

  2. Click Add next to Jira API and configure the scopes you need

Minimal scopes (required for basic functionality):

read:jira-user
read:jira-work
write:jira-work
manage:jira-project
read:project:jira

Additional scopes for specific endpoints:

read:issue:jira
write:issue:jira
read:attachment:jira

Jira Software (Agile) scopes — for boards, sprints, and backlog:

read:board-scope:jira-software
write:board-scope:jira-software
read:board-scope.admin:jira-software
write:board-scope.admin:jira-software
read:sprint:jira-software
write:sprint:jira-software

  1. In the left sidebar, go to Authorization

  2. Click Add next to OAuth 2.0 (3LO)

  1. Set the Callback URL:
    • For SaaS deployments: https://{org}.mcp-s.com/{org}/api/auth/callback
    • For On-Premise deployments: {connectUrl}/{org}/api/auth/callback

  1. Click Save changes

  2. In the left sidebar, go to Settings

  3. Copy the Client ID and Secret

  1. In Willow, paste the Client ID and Client Secret

  2. Select the same scopes you configured in Atlassian, and also add offline_access

  3. Enter your Jira Organization Domain in Configuration.

    Since OAuth uses the Atlassian API gateway, the base URL should be:

    https://api.atlassian.com/ex/jira/{cloudId}

    For example: https://api.atlassian.com/ex/jira/e1acb0fb-318d-4fc3-ba56-db2b0ae14466

    To find your Cloud ID, open the following URL in your browser (replace your-org with your Jira subdomain):

    https://your-org.atlassian.net/_edge/tenant_info

    Copy the cloudId value from the JSON response.

  4. Click Save Changes

Setting up Instant OAuth​

  1. Click Connect to sign in with your Atlassian account.

  2. Find your Cloud ID by opening the following URL in your browser (replace your-org with your Jira subdomain):

    https://your-org.atlassian.net/_edge/tenant_info

    Copy the cloudId value from the response.

  3. In General Settings, enter your Jira organization domain using this format:

    https://api.atlassian.com/ex/jira/{cloudId}

    Replace {cloudId} with the value copied in the previous step.

  4. Click Save Changes.

Generating an API Key​

  1. Go to https://id.atlassian.com/manage-profile/security/api-tokens

  1. Click Create API token

  2. Give your token a descriptive label

  1. Click Create

  2. Copy the token immediately

  3. In Willow, enter the API key in the format: [email protected]:your-api-token

On this page