Prepare in Jira

  1. To complete this procedure, you need an Atlassian account with the Create issues project permission, which enables you to create new tickets in an existing Jira project.
  2. If you want to be able to use the Assignee field, you additionally need Browse users and groups global permission.
  3. You must also either already have default fields set up for the Jira project you want to add as an integration. Default fields let you specify the project and the issue type for tickets created using the Jira integration. For more information, see Atlassian's page, Add, edit, and delete a field configuration.
  4. Find your Jira project Key
    • Open your Jira project.
    • On the project sidebar, select Project settings > Details.
    • Note the value of Key. This is your project key.

Set up the Jira integration in Lightup

  1. Select the workspace where you want to add an integration, and then on the workspace menu select Integrations.

  2. Select Create Integration +.

  1. In the list that appears, select Jira.
  2. In the Add Jira Integration dialog, supply the following information:
    • Mode: Select Auto if you want to add the integration to an alerting channel so that incidents can generate tickets automatically. Note that a monitor must have the alerting channel added to it before its incidents can generate tickets automatically. Select Manual to prevent the Jira integration from being added to an alerting channel. Users must manually submit a Jira ticket via the incident.
    • Name: A name for the integration
    • Jira Server: The URL of your Jira site. It should resemble https://yoursitename.atlassian.net.
    • Username: Your account name on Jira.
    • API Token: Enter your Jira API token.
  3. Select Authenticate.
  4. When authentication succeeds, select Project and choose the Jira project for the integration.
  5. When you choose the project, you can then pick an Issue type. The issue type determines which fields can be collected in a ticket.
  6. Under Select the fields to include, click the box to add a field. The fields you can add depend on the Issue type you set in the previous step. Click the X on a field to delete it from the box (and hence, omit it from tickets using the integration).
  7. Under Defaults, you can change the default setting for any field that you added in the previous step. Initial defaults are inherited from Jira.
  8. Optionally, select Create a test ticket to make sure it works as expected.
  9. At the top right, select Add.

You can add multiple Jira integrations to a workspace— just repeat the procedure with any needed adjustments. If there is more than one Jira integration, users can pick which one to use when they submit a ticket.