Skip to content
API reference Go to app

Configure Linear

1 min read

Linear integrations let Hawzu create and link Linear issues from defects.


Prepare a Linear API Key from Linear settings.

Use a key that has read and write access for the Linear teams where Hawzu should create issues.


  1. Open the workspace Integrations page.
  2. Select Add Integration.
  3. Search for Linear and select it.
  4. Add an optional integration name and description.
  5. Choose All Projects or Selected Projects.

Project scope controls which Hawzu projects can use the Linear connection.


Enter the Linear API key and select Test Connection.

If the connection fails, review the key and Linear access before trying again.


After a successful connection, choose the Linear defaults used when Hawzu creates external issues from defects:

  • Default Team
  • Default State, when available

The team is required. The state is optional and depends on the selected Linear team.


Save is available after the connection succeeds and the required Linear team is selected.

After saving, Linear appears in the Integrations table with its status, project scope, and configuration details. Users with access can create Linear issues from Hawzu defects and link existing Linear issues.