Creating an App Link

Once you've added the Workflow Steps for Jira app to your workspace and you want to connect to a Jira Server or Data Center instance, you first need to set up an application link with your Jira instance. Remember, you must have admin access in your Jira instance to set up an app link!

  1. From Slack, click Workflow Steps for Jira in the Apps section.

    The app opens to the Home tab.

    If the app isn't in your list of apps, click the + and search for it by name.
  2. Click Create App Link.

    The Configure New Instance wizard opens. 

  3. Wizard Step 1:
    1. Enter a Jira instance name.
    2. Enter the base URL for the Jira instance you want to connect to your Slack workspace.

      While base URLs usually end in .com, yours may extend beyond that.
    3. Click Next.

  4. Wizard Step 2:
    1. Click Application Links.
      A new browser tab opens to a Jira Administration page. (You may have to log in to your Jira instance.)
    2. Enter into the text field, then click Create New Link.
    3. Return to the wizard and click Next.

  5. Wizard Step 3:
    1. On the Jira browser tab, click Continue when the "No response was received from the URL entered" message appears.
    2. Enter Workflow Steps for Jira in the Application Name field.
    3. Check the Create incoming link checkbox, and leave the remaining fields blank.
    4. Click Continue.
      The Link Applications page appears.
    5. Return to the wizard and click Next.

  6. Wizard Step 4:
    1. In the Jira browser tab:
      • Type steps_for_jira in the Consumer Key field.
      • Type steps_for_jira in the Consumer Name field.
      • And copy/paste the public key text from Step 4 of the wizard into the Public Key field, including the begin/end public key text:
    2. In the Jira browser tab, click Continue.
      A successfully configured app link looks similar to this:
    3. Return to the wizard and click Finish.
      A congratulatory message appears—and deservedly so!

What's Next? ➡️

Finished creating a new app link? Sounds like it's time to authenticate with your Jira instance.

Having issues? 🔧

See our tips at Troubleshoot Connections.