Linear Connector

Connect Zenmako to Linear to manage issues, projects, and sprints. This enables AI to view and update issues, track project progress, manage team workflows, and help keep development on track.

Getting Your API Key

Linear uses API Keys for authentication. Follow these steps to generate one:

Go to https://linear.app/settings/api

Scroll down to the Personal API keys section

Click Create key

Give your key a descriptive label (e.g., "Zenmako Integration")

Click Create key

Copy the key immediately (it will only be shown once)

Store your API key securely. The key has the same permissions as your Linear account, so it can access all workspaces, teams, and issues you have access to.

Connecting Linear

Navigate to the Connections page in Zenmako

Click Add Connection and select Linear

Enter your credentials:

- API Key: Paste the API key you generated

Click Save

Click Test Connection to verify the setup works

If the test succeeds, your Linear connection is ready to use.

Available Actions

Action

Description

listIssues	Get issues with optional filters by team, assignee, creator, state, project, or label
searchIssues	Search for issues by keyword
createIssue	Create a new issue with title, description, priority, assignee, labels, and more
updateIssue	Update an existing issue's status, assignee, priority, labels, or other fields
listProjects	Get all projects in your Linear workspace
getProject	Get detailed information about a specific project
listCycles	Get current sprints/cycles, optionally filtered by team
listTeams	Get all teams in your workspace
getTeam	Get team details including workflow states and members
createComment	Add a comment to an issue
listComments	Get all comments on an issue
listIssueLabels	Get available labels for categorizing issues
listUsers	Get all users/team members in the workspace
getViewer	Get information about the authenticated user
listWorkflowStates	Get available workflow states (To Do, In Progress, Done, etc.)

Example Prompts

Try these prompts to interact with your Linear data:

"Show me all issues assigned to me in Linear"

"Search for issues related to authentication"

"Create a bug report titled 'Login page crashes on mobile' with high priority"

"What is the current status of the Mobile App project?"

"Move the API refactor issue to In Progress and assign it to John"

"Add a comment to issue ENG-123 saying 'Fixed in PR #456'"

"What issues are in the current sprint for the Engineering team?"

Common Issues

"Invalid API key" or "Authentication failed" error

This typically means your API key is invalid or has been revoked. Solutions:

Verify you copied the complete API key without extra spaces

Check that the key has not been deleted in Linear's settings

Generate a new API key if needed

Cannot find team or project IDs

Many actions require team or project IDs. To find these:

Use the listTeams action to get team IDs

Use the listProjects action to get project IDs

Use the listWorkflowStates action to get state IDs for status updates