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

# Connect Your Linear Workspace to NOCK in a Few Minutes

> Generate a Linear API key, enter it in NOCK Settings, and verify your connection so that new tickets flow into Linear automatically.

Before NOCK can create or synchronize issues in Linear, you need to give it a way to authenticate with your Linear workspace. You do this by generating a personal API key inside Linear and pasting it into NOCK's integration settings. The whole process takes less than five minutes and does not require any changes to your Linear workspace configuration.

## What permissions your API key needs

NOCK uses your API key to perform two operations in Linear:

| Operation          | Why NOCK needs it                                                 |
| ------------------ | ----------------------------------------------------------------- |
| **Issue — create** | Creates a new Linear issue whenever a ticket is submitted in NOCK |
| **Issue — read**   | Reads issue status so changes sync back to NOCK                   |

A personal API key inherits the permissions of the Linear account that generated it. Make sure the account you use has at least **Member** access to the teams where you want issues created.

<Note>
  NOCK does not need — and does not request — write access to any part of your Linear workspace beyond issues. It will not modify your teams, projects, cycles, or workspace settings.
</Note>

## Step-by-step: connect Linear to NOCK

<Steps>
  <Step title="Open Linear API settings">
    In Linear, click your **workspace name** in the top-left corner, then navigate to **Settings → API**. You can also go directly to `linear.app/settings/api`.
  </Step>

  <Step title="Create a personal API key">
    Under **Personal API keys**, click **Create key**. Give the key a recognisable label — for example, `NOCK integration` — so you can identify it later. Click **Create** to generate the key.

    <Warning>
      Linear shows the full API key only once, immediately after creation. Copy it to your clipboard before closing the dialog — you cannot retrieve it again.
    </Warning>
  </Step>

  <Step title="Open NOCK integration settings">
    In NOCK, go to **Settings → Integrations → Linear**. You will see a field labelled **Linear API key**.
  </Step>

  <Step title="Paste your API key">
    Paste the key you copied from Linear into the **Linear API key** field, then click **Save**.
  </Step>

  <Step title="Verify the connection">
    After saving, NOCK attempts to authenticate with Linear using the key you provided. If the connection succeeds, a green **Connected** badge appears next to your Linear workspace name.

    If you see an error instead, check the [Troubleshooting](/linear/troubleshooting) page for common causes.
  </Step>
</Steps>

## Security and credential storage

NOCK stores your Linear credentials encrypted and uses them only to create or synchronize issues in your selected workspace.

<Tip>
  If you ever rotate or revoke the API key in Linear, return to **Settings → Integrations → Linear** in NOCK and update the key immediately to avoid a sync interruption.
</Tip>

## Next steps

Once your connection is verified, configure which Linear team and project should receive new issues.

<Card title="Choose a Team & Project" icon="folder-open" href="/linear/choose-team-and-project">
  Select the Linear team and project that new NOCK tickets will be sent to.
</Card>