# Jira Integration

Connect Brizz to Jira to create and track issues found by Brizz directly from your Jira workspace.

Connect Brizz to your Jira Cloud workspace to create and track Jira tickets directly from Brizz issues.

## Why Connect Jira?

Integrating Jira with Brizz enables:

- **Create Issues in Jira from Issues in Brizz**: Turn Brizz issues into trackable Jira tickets with a single click
- **Read Linked Issues**: View Jira ticket status directly from the Brizz dashboard
- **Streamlined Workflows**: Bridge the gap between AI observability and your existing issue tracking

## How to Connect

1. Navigate to **Settings > Integrations** in the Brizz dashboard
2. Click **Connect Jira**
3. You'll be redirected to Atlassian to authorize Brizz
4. Select the Jira site you want to connect (if you have multiple)
5. Return to Brizz to complete the setup

## Required Permissions

When you connect Jira, Brizz requests the following permissions:

| Permission        | Why We Need It                                                                 |
| ----------------- | ------------------------------------------------------------------------------ |
| `read:jira-work`  | Read linked issues, projects, and boards to display Jira ticket status in Brizz |
| `read:jira-user`  | Read user information for displaying assignees and reporters on linked issues  |
| `write:jira-work` | Create Jira issues from Brizz issues with full context and details             |
| `manage:jira-webhook` | Register the webhooks that mirror Jira ticket status changes back to Brizz |
| `offline_access`  | Maintain the connection without requiring you to re-authorize frequently       |

## Creating Jira Issues

Once connected, you can create Jira issues from any Brizz issue:

1. Navigate to the **Issues** page in Brizz
2. Click on an issue to view its details
3. Click **Create Jira Issue**
4. Select the Jira project and issue type
5. Review and customize the issue details
6. Click **Create** to create the ticket in Jira

The Jira issue will include:
- Issue title and description from Brizz
- Link back to the Brizz issue for full context
- The affected sessions, linked back to Brizz

## Managing the Integration

To disconnect or reconfigure the Jira integration:

1. Go to **Settings > Integrations**
2. Find the Jira integration card
3. Click **Disconnect** to remove the integration

After disconnecting, any previously created Jira issues will remain in Jira, but you won't be able to create new issues or see linked ticket status in Brizz.

## See also

- [Issue trackers](/docs/integrations/issue-trackers.md) — Linear and Monday also create and attach tickets, with their own flows.
- [Slack](/docs/integrations/slack.md) — notifications rather than ticketing.
- [Issues](/docs/platform/issues.md) — the source of what Jira tickets get created from.