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

# Tickets, Incidents & Delivery

> Connect Jira, Linear, Incident.io, Slack, and CircleCI.

These connections add context around the code: what work was planned, what broke, where conversations happen, and how things ship.

All are connected from **Admin → Connections** in the [Bilanc dashboard](https://app.bilanc.co), under the section noted for each.

***

## Jira

*Section: Ticket Management*

Jira powers issue, sprint, and cycle-time metrics.

**Who needs to do it:** any user with access to the projects you want tracked. A **site admin** is recommended so all relevant projects are visible.

### Steps

1. On the **Jira** card, click **Connect**.
2. Authorize Bilanc and select the Jira site you want to track.

***

## Linear

*Section: Ticket Management*

**Who needs to do it:** a **workspace admin** — the API key inherits the creator's access, so an admin's key covers the whole workspace.

### Steps

1. Go to [Linear → Settings → API](https://linear.app/settings/api) and click **Create new API key**.
2. Give it a name (e.g. "Bilanc") and copy the key.
3. In Bilanc, click **Connect** on the **Linear** card and paste the key.

***

## Incident.io

*Section: Incident Management*

Incident data powers reliability and incident-response metrics.

**Who needs to do it:** an **Incident.io admin**.

### Steps

1. In Incident.io, go to [Settings → API keys](https://app.incident.io/settings/api-keys) and click **Add new**.
2. Give it a name and grant read access to incidents. Copy the token — it's only shown once.
3. In Bilanc, click **Connect** on the **Incident.io** card and paste the token.

***

## Slack

*Section: Communication*

Connecting Slack lets Bilanc surface activity and notifications in the channels your teams use.

**Who needs to do it:** anyone who can **install Slack apps** in your workspace (depending on your Slack settings, this may need a workspace admin to approve).

### Steps

1. On the **Slack** card, click **Connect**.
2. Authorize Bilanc and pick the workspace.

***

## CircleCI

*Section: Workflow Management*

CircleCI powers pipeline and deployment-frequency metrics.

**Who needs to do it:** any team member — the **personal API token** inherits that person's project access, so use an account that can see the projects you care about.

### Steps

1. In CircleCI, go to **User Settings → Personal API Tokens** and click **Create New Token**.
2. Name it (e.g. "Bilanc") and copy the token — you won't be able to view it again.
3. In Bilanc, click **Connect** on the **CircleCI** card and paste the token.