The JIRA integration allows previews of issues in JIRA within Outline. For example, hovering over a JIRA mention will show a preview of the issue status at that url.

Setup

1. Register a new “OAuth 2.0 Integration”, you’ll need to fill out the following fields:

• Name – “Outline” might make sense

• Permissions – Choose the following 3 scopes:

  • User Identity API: read:me

  • JIRA API: read:jira-work, read:jira-user

• Authorization – Add “OAuth 2.0”, under callback URL use <yourdomain.com>/api/jira.callback

• Settings – Record the Client ID and Secret

2. Add the configuration to the Outline environment, using the following variable names:

   JIRA_CLIENT_ID=
   JIRA_CLIENT_SECRET=

3. Restart the server, you should see “JIRA” available under Settings → Integrations