# Linear

### Generate an API key

First, you'll need to generate a Linear API key.&#x20;

1. Navigate to [Security & access](https://linear.app/settings/account/security) in your Linear settings, then in the "Personal API keys" section, click **New API key**.
2. Provide a name for your key (eg. "Violet integration"), then confirm **Read** and **Write** permission&#x73;**.**
   1. You can also keep this set to the default Full Access - Violet does not access any admin-only features.
3. \[Optional] Select specific teams that should be accessible by this key.
4. Click **Create**, and copy the key that appears. Note, you won't be able to access this key again (but you can always create another one).

<figure><img src="https://2091741164-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvrraExym8pNEUvBDoima%2Fuploads%2FpEcDhnh57BfFIaSm0MDu%2FScreenshot%202026-02-05%20at%208.03.12%E2%80%AFAM.png?alt=media&#x26;token=6195e11a-df8d-440c-8b94-74d12428df42" alt="" width="375"><figcaption></figcaption></figure>

### **Connect Linear in Violet**

1. In [Violet](https://app.violetlabs.com/) (or [VioletGov](https://app.violetgov.com/)), navigate to **Integrations** and click  <img src="https://2091741164-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvrraExym8pNEUvBDoima%2Fuploads%2FtlFf29W81Xw97AUJ5zwb%2FScreenshot%202026-02-19%20at%201.13.34%E2%80%AFPM.png?alt=media&#x26;token=c80f613a-d379-4cd4-a5c8-9c04e63e37ea" alt="" data-size="line"> to add a new integration.&#x20;
2. Select <img src="https://2091741164-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvrraExym8pNEUvBDoima%2Fuploads%2Fm03jtdl7LceaWX57j94T%2Flinear.png?alt=media&#x26;token=77e991eb-a1de-496a-b011-e22fec2653e2" alt="" data-size="line"> **Linear**

\[Optional] You can also provide a unique name for the connection based on the credentials you're using, and you can create **restricted permissions** to users or groups:

<figure><img src="https://2091741164-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvrraExym8pNEUvBDoima%2Fuploads%2FLNq8XfPFudyBudwAhJwe%2Fpermissions.png?alt=media&#x26;token=502752e3-2f38-4c8b-8fa0-2ff8b3a5a19a" alt="" width="375"><figcaption></figcaption></figure>

3. Enter your API Key and click **Connect**
4. Once connected, configure your integration (optional), then click **Create.** You're done!
