Connect Linear
Generate a Linear API key, save it in NOCK workspace settings, then enable Linear sync for each project that should create Linear issues.
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.
Step-by-step: connect Linear to NOCK
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.
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.
Open NOCK workspace settings
In NOCK, open the workspace settings page. Under Linear integration, you will see the API key field.
Paste your API key
Paste the key you copied from Linear into the Linear API key field, then click Save.
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 for the workspace.
If you see an error instead, check the Troubleshooting page for common causes.
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 workspace settings in NOCK and update the key immediately to avoid a sync interruption.
Next steps
Once your workspace connection is verified, open a project and configure Settings > Linear sync for the team, optional project, and sync toggle.
Choose a Team & Project
Select the Linear team and project that new NOCK tickets will be sent to.