# Linear

{% hint style="info" %}
This integration is currently in beta.
{% endhint %}

## Linear Setup

Generate an API key in Linear:

1. Log in to your Linear workspace at **linear.app**.
2. Navigate to **Settings > Security & access**.
3. Under **Personal API Keys**, click **New API Key**.
4. Give your key a descriptive name (e.g., "Halo Security Integration").
5. Copy the generated API key.

## Connect Linear to Halo Security

1. Navigate to *Settings → Integrations →* [Add](https://app.halosecurity.com/user/settings/integrations/add).
2. Select **Linear** from the list of available integrations.
3. Name the integration and click **Add**.
4. Enter your **API Key**.
5. Click **Save**.

## Create Profiles

After connecting Jira, you can create profiles to control how tickets are created. To create a profile:

1. Navigate to the **Profiles** tab
2. Click the **+** icon
3. Enter a name for the profile
4. Configure your settings:
   1. **Team**
   2. **Project**
   3. **Assigned To**
   4. **Default Priority**
5. Click **Save**

## Create Issues

### Manually Create Linear Issues

When viewing an [Issue](https://docs.halosecurity.com/docs/platform/issues), you can easily create an individual Linear issue for the issue.

1. Click the **Plug icon** in the top right
2. Select the Profile you'd like to use
3. Make any adjustments to the ticket details
4. Click **Create Issue**

### Automatically Create Linear Issues for Halo Security Issues

To create tickets for issues, we recommend using Automations.;

* Navigate to *Settings →* [Automations](https://app.halosecurity.com/user/settings/automations/)
* Create a filter with the type as **Target Issue**
* Apply the profile you created as an action

Learn more about Automations:

{% content-ref url="../../platform/automations" %}
[automations](https://docs.halosecurity.com/docs/platform/automations)
{% endcontent-ref %}

### Automatically Create Linear Issues for Additional Events

Event rules allow you to create a Linear issues for Halo Security events beyond issues. For example, you can create a Linear issue when a new port is opened or a new target is added.

To receive Linear issues, create Event Rules and add your Linear profile as an action.

Visit *Events →* [Event Rules](https://app.halosecurity.com/user/settings/event-rules/) to set up rules that determine which events created Tickets in Jira.

Learn more about configuring Event Rules:

{% content-ref url="../../platform/events/alerts" %}
[alerts](https://docs.halosecurity.com/docs/platform/events/alerts)
{% endcontent-ref %}