> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cysmiq.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect ticketing

> Set up ticketing integrations for vulnerability workflows.

## Overview

Connecting a ticketing system lets you create and track tickets directly from vulnerabilities. This guide covers Jira and Linear.

## Steps

<Steps>
  <Step title="Open Integrations">
    From your workspace, open **Settings** and select **Integrations**.

    <Frame caption="The Integrations page shows available ticketing connections.">
      <img src="https://mintcdn.com/cysmiq/b1Lbo3Hes6--JS1V/images/guides/connect-ticketing/ticketing-01-integrations.webp?fit=max&auto=format&n=b1Lbo3Hes6--JS1V&q=85&s=92850a51f9363decba003798ebc7fcc0" alt="Integrations page showing Jira and Linear options in the Ticketing section." width="2880" height="2160" data-path="images/guides/connect-ticketing/ticketing-01-integrations.webp" />
    </Frame>
  </Step>

  <Step title="Add a ticketing integration">
    <Tabs>
      <Tab title="Jira">
        Prerequisites:

        * Jira Cloud or Jira Data Center access with permission to create issues
        * A Jira API token or personal access token

        Select **Add Jira** to open the setup form. Enter the following details:

        * **Display Name**: A name to identify this integration
        * **Base URL**: Your Jira instance URL, such as `https://yourcompany.atlassian.net` or your Jira Data Center URL
        * **Project Key**: The key of the project where tickets will be created, such as `KAN`
        * **Issue Type**: The type of issue to create, such as `Task` or `Bug`
        * **Email**: The email address associated with your Jira account
        * **API Token**: A Jira API token for Jira Cloud or a personal access token for Jira Data Center. For help generating a token, see [Atlassian's documentation](https://support.atlassian.com/atlassian-account/docs/manage-api-tokens-for-your-atlassian-account/)

        <Frame caption="Jira form filled with connection details.">
          <img src="https://mintcdn.com/cysmiq/b1Lbo3Hes6--JS1V/images/guides/connect-ticketing/jira-02-form-filled.webp?fit=max&auto=format&n=b1Lbo3Hes6--JS1V&q=85&s=c69a1e6a6947d8370eb4f25b42240a16" alt="Jira setup form completed with display name, base URL, project key, issue type, email, and API token." width="2768" height="3059" data-path="images/guides/connect-ticketing/jira-02-form-filled.webp" />
        </Frame>

        Select **Save Changes** to connect the integration.
      </Tab>

      <Tab title="Linear">
        Prerequisites:

        * A Linear workspace with a personal API key that has the `read` and `write` scopes

        Select **Add Linear** to open the setup form. Enter the following details:

        * **Display Name**: A name to identify this integration
        * **Team Key**: The short code for your Linear team, visible in issue identifiers (for example, `SEC` in `SEC-123`)
        * **API Key**: A Linear personal API key with the `read` and `write` scopes. To generate a key, go to Linear's [Security & Access](https://linear.app/settings/account/security) settings

        <Frame caption="Linear form filled with connection details.">
          <img src="https://mintcdn.com/cysmiq/b1Lbo3Hes6--JS1V/images/guides/connect-ticketing/linear-01-form-filled.webp?fit=max&auto=format&n=b1Lbo3Hes6--JS1V&q=85&s=e6ca49a6fbfb60ffab697cfd578845e1" alt="Linear setup form completed with display name, team key, and API key." width="2252" height="1438" data-path="images/guides/connect-ticketing/linear-01-form-filled.webp" />
        </Frame>

        Select **Verify Connection** to connect to Linear and load your team's workflow states.

        <Frame caption="Connection verified with workflow states loaded.">
          <img src="https://mintcdn.com/cysmiq/b1Lbo3Hes6--JS1V/images/guides/connect-ticketing/linear-02-states-dropdown.webp?fit=max&auto=format&n=b1Lbo3Hes6--JS1V&q=85&s=84a64f6891b973e88e26e12503ad67c4" alt="Linear form showing verified connection and dropdown with workflow states like Todo, In Progress, and Done." width="2880" height="2160" data-path="images/guides/connect-ticketing/linear-02-states-dropdown.webp" />
        </Frame>

        Choose a **Default State** for new tickets. Select a state like **Todo** or **Backlog**, or leave it as **Use Linear default** to use Linear's default state.

        Select **Save Changes** to connect the integration.
      </Tab>
    </Tabs>
  </Step>

  <Step title="Verify the connection">
    <Tabs>
      <Tab title="Jira">
        Return to **Integrations** to confirm Jira is connected.

        <Frame caption="Jira shows as connected in Cysmiq.">
          <img src="https://mintcdn.com/cysmiq/b1Lbo3Hes6--JS1V/images/guides/connect-ticketing/jira-03-connected.webp?fit=max&auto=format&n=b1Lbo3Hes6--JS1V&q=85&s=aac4f137fbb2878274f5cb34264df482" alt="Integrations page showing Jira connected with project key and issue type." width="2252" height="290" data-path="images/guides/connect-ticketing/jira-03-connected.webp" />
        </Frame>
      </Tab>

      <Tab title="Linear">
        Return to **Integrations** to confirm Linear is connected.

        <Frame caption="Linear shows as connected in Cysmiq.">
          <img src="https://mintcdn.com/cysmiq/b1Lbo3Hes6--JS1V/images/guides/connect-ticketing/linear-03-connected.webp?fit=max&auto=format&n=b1Lbo3Hes6--JS1V&q=85&s=62bda4d57176483817a8405be26b22ef" alt="Integrations page showing Linear connected with team key." width="2252" height="290" data-path="images/guides/connect-ticketing/linear-03-connected.webp" />
        </Frame>
      </Tab>
    </Tabs>
  </Step>
</Steps>

## Next steps

* [Create tickets](/guides/create-tickets)