Skip to main content

Jira connection

Learn how to connect with Jira

Actioner connects with Jira through OAuth2 and API key.

Add a new Jira connection​

If your app contains a Jira connection, you can skip this step and proceed to authentication with your credentials.

To add a new connection, go to App settings tab of your app and click + Add new connection. Select Jira (OAuth2) or Jira (API) option and enter a name.

Add new Jira connection

Note

You have to be an app admin to add a new connection to your app.

OAuth2 authentication with Jira​

To authenticate in Jira with OAuth2

  1. Click Connect near the Jira connection. You can find the connection on Description tab of your app.
Info

If you are an app admin, you can also update connection properties and complete authentication on App settings tab of your app.

  1. You will be asked to sign in to your Jira instance if you haven't already.

  2. Select your Jira instance that will connect with your Actioner workspace.

  3. Click Accept to grant permission to Actioner app in Jira. You’ll be redirected to Actioner upon successful authorization.

API key authentication with Jira​

To authenticate with Jira API via an API Token

  1. Log in to https://id.atlassian.com/manage/api-tokens.

  2. Click Create API token.

  3. From the dialog that appears, enter a memorable and concise Label for your token and click Create. and then click Copy to clipboard.

  4. In Actioner, Click Connect near the Jira connection. You can find the connection on Description tab of your app.

Info

If you are an app admin, you can also update connection properties and complete authentication on App settings tab of your app.

  1. Enter https://jiradomain.atlassian.net in Base URL field by replacing jiradomain with your Jira instance.

  2. Enter your Jira login email to Username and the copied API key to API key field.

Sharing scope​

If you are an app admin, you can enable Shared credentials option if you want all users to run actions with the credentials you entered. When disabled, to execute requests and actions, each user completes authentication with their credentials.

Note

You need to Reconnect after enabling or disabling Shared credentials.

Reconnecting​

If your Jira instance URL or credentials change, you can reconnect Actioner with Jira.

Find the connection on Description tab of your app, click ... ellipsis and select Reconnect. Enter your credentials and complete authorization on the opening screen.

Info

If you are an app admin, you can also reconnect on App settings tab of your app.