# Linear

### Prerequisites

* A Linear account with sufficient access to the workspace & projects you wish to sync with Coworker.

### Generating the credentials

1. Go to [https://linear.app/settings/account/security](https://linear.app/settings/account/security) to start the api key process. Note: Make sure you're on the correct workspace.
   * Alternatively, go to [https://www.linear.app](https://www.linear.app) and navigate to the workplace settings in the top left corner. Then, navigate to the Security & access section.

<figure><img src="https://3561055466-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcl1KIMhPQkmG41x5eGvL%2Fuploads%2FlOeCvzpvLOvDXgTlWESR%2FScreenshot%202024-06-03%20at%208.05.08%E2%80%AFAM.png?alt=media&#x26;token=f8b3f0db-d9be-4d78-97b0-149e35d8c24a" alt="" width="121"><figcaption><p>Navigating to workplace settings</p></figcaption></figure>

2. Create a new API key. First give it a label like "coworker-integration", then click "Create new API key".&#x20;

<figure><img src="https://3561055466-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcl1KIMhPQkmG41x5eGvL%2Fuploads%2FGSmXf4RjKGNdUUhOLrEv%2FScreenshot%202024-06-03%20at%208.14.11%E2%80%AFAM.png?alt=media&#x26;token=f2bbceed-5016-44a9-b960-7eb4dd116d06" alt="" width="375"><figcaption><p>Generating API key</p></figcaption></figure>

3. **IMPORTANT: Your API key is automatically copied to your clipboard once it's created. You won't be able to view it later, so please save it somewhere secure now.**

### Information required for the Coworker connection:

* `auth_token`: The personal API key you generated earlier
* `workspace_name`: Workspace identifier, used in your workspace URL (ie. `linear.app/[my-workspace]` -> `my-workspace`)
