Skip to content

Jira credentials#

You can use these credentials to authenticate the following nodes:

Prerequisites#

Create a Jira Software Cloud or Server account.

Supported authentication methods#

Refer to Jira's API documentation for more information about the service.

Using SW Cloud OAuth2#

To configure this credential, you'll need an account on Jira Software Cloud and access to the Atlassian Developer Console.

Then:

  1. Open the Atlassian Developer Console and select Create > OAuth 2.0 integration.
  2. Enter a Name for your app and agree to the terms, then select Create.
  3. Select Authorization in the left sidebar.
  4. Next to OAuth 2.0 (3LO), select Add.
  5. In n8n, copy the OAuth Redirect URL.
  6. Paste the URL into the Callback URL field in the Atlassian Developer Console.
  7. Select Save changes.
  8. Select Permissions in the left sidebar, then select Add next to Jira API.
  9. Select Configure next to Jira API > Edit Scopes. Enable at minimum these scopes, then save your edits:
    • read:jira-user
    • read:jira-work
    • write:jira-work
    • manage:jira-webhook
    • manage:jira-user
    • offline_access
  10. Select Settings in the left sidebar.
  11. Copy the Client ID and paste it into n8n.
  12. Copy the Secret and paste it as the Client Secret in n8n.
  13. Enter the Domain you access Jira on, for example https://example.atlassian.net.
  14. Select Connect to Jira SW Cloud and follow the prompts to complete the OAuth2 flow.

Refer to OAuth 2.0 (3LO) apps in Atlassian's documentation for more information.

Using SW Cloud API token#

To configure this credential, you'll need an account on Jira Software Cloud.

Then:

  1. Log in to your Atlassian profile > Security > API tokens page, or jump straight there using this link.
  2. Select Create API Token.
  3. Enter a Name for your token, like n8n integration.
  4. Set an Expires on date, or leave the default date.
  5. Select Create.
  6. Copy the API token.
  7. In n8n, enter the Email address associated with your Jira account.
  8. Paste the API token you copied as your API Token.
  9. Enter the Domain you access Jira on, for example https://example.atlassian.net.

Refer to Manage API tokens for your Atlassian account for more information.

New tokens

New tokens may take up to a minute before they work. If your credential verification fails the first time, wait a minute before retrying.

Using SW Server account#

To configure this credential, you'll need an account on Jira Software Server.

Then:

  1. Enter the Email address associated with your Jira account.
  2. Enter your Jira account Password.
  3. Enter the Domain you access Jira on.
This page was