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

# Jira

> Connect Jira to let ewake create incident tickets and cross-reference open issues during investigations.

<Info>
  **What you'll get:** ewake can create Jira tickets directly from an incident investigation, pre-populated with context, hypotheses, and evidence, and cross-reference open issues with production problems to surface in-progress work that might explain unexpected behaviour.
</Info>

***

## Prerequisites

* An Atlassian account with access to your Jira workspace
* Permission to create API tokens in Atlassian

***

## Configuration

<Steps>
  <Step title="Create an API token in Atlassian">
    Go to [id.atlassian.com](https://id.atlassian.com) → **Security** → **Create and manage API tokens** → click **Create API token**.

    Give it a label (e.g. `ewake`) and copy the token immediately.

    <Note>
      Copy the token now, Atlassian will not show it again after closing the modal.
    </Note>
  </Step>

  <Step title="Note your Jira base URL">
    Your Jira URL follows this format:

    ```
    https://your-org.atlassian.net
    ```
  </Step>

  <Step title="Connect in ewake">
    In your ewake dashboard, go to **Integrations** → **Jira** → click **Configure**.

    | Field             | Value                                       |
    | ----------------- | ------------------------------------------- |
    | **Email**         | The email address of your Atlassian account |
    | **API Token**     | The token created in Step 1                 |
    | **Jira Base URL** | Your Jira URL from Step 2                   |

    Click **Test Configuration**, then **Save**.
  </Step>

  <Step title="Select projects to index">
    Choose which Jira projects ewake should have access to.

    <Check>
      Jira is connected. Ewake can now reference and create tickets from the investigation flow.
    </Check>
  </Step>
</Steps>