Skip to main content

Jira connection

Learn how to connect your Jira instance.

To execute workflows with Jira actions and to initiate workflows starting with a Jira event, you need to connect your Jira account with Actioner.

When designing your own workflows, you can use your Jira connection for Jira actions and triggers.

To see your Jira connections, go to your profile and navigate to My connections tab.

Connecting Jira​

Actioner connects with Jira through OAuth2 and API key.

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.

  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.

  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​

You can enable Shared option to execute Jira actions by the selected app's workflows. It's important to clarify that sharing your connection doesn't equate to sharing your credentials. Instead, it grants access to workflows to use your connection for execution. Rest assured, your credentials remain concealed and inaccessible to other users.

Additionally, enabling Shared option doesn't automatically start using your connection for every Jira interaction. Instead, your shared connection credentials are used only when explicitly chosen. However, note that that enabling Shared option makes your connection accessible to all app admins when designing workflows in your app.

Reconnecting​

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

Go to Profile settings page from left bottom corner, navigate to My connections tab and then click ... ellipsis and select Reconnect. Enter your credentials and complete authorization on the opening screen.