Introduction
Connect Linear to Sana to search, create, and manage issues, initiatives, views, and comments across your teams and projects. Triage bugs and track progress without leaving Sana. In summary, the connector has the following key characteristics:
Category: Project management
Connector type: Real-time
Auth type: OAuth
Hosting type: Managed
Capabilities
This connector is able to do the following:
Capability |
List teams |
List projects |
Create projects |
Search issues |
Create issues |
Update issues |
Manage initiatives |
List views |
Comment on issues |
Tools
While the capabilities above describe what the connector can do at a high level, the underlying tools show exactly which operations the agent can use when you ask Sana about Linear. In practice, the agent may call one or more tools to achieve a single capability.
Tool |
Create comment |
Create initiative |
Create issue |
Create project |
Get current user |
Get issue |
Get teams |
Get view issues |
List comments |
List initiatives |
List projects |
List views |
Remove label from issue |
Search issues |
Update initiative |
Update issue |
Scope and permissions
This connector uses OAuth. When you connect your account, you will need to sign into your account and grant the required permissions:
Scope | Purpose |
admin | Read configs of custom workspace-level settings |
read | Read teams, projects, and issues |
write | Update existing issues |
issues:create | Create new issues |
Set up instructions
Prerequisites:
Your Sana workspace admin has enabled this integration – if the workspace admin has disabled the integration it won't appear in the list of available integrations.
Step 1: Go to the integrations page in Sana
In Sana, click on ... More in the sidebar, then select Integrations
Step 2: Find Linear in the list of available integrations
Scroll to the Available integrations section and locate Linear.
Step 3: Connect the integration
Click the integration card and select "Connect just for me", this will open a pop-up powered by Pipedream. Follow the steps in the pop-up to complete the set-up.
Step 4: Sign in to Linear and approve the requested scopes
You'll be redirected to Linear to go through their OAuth flow. Sign in and approve the scopes Sana needs to operate the connector.
Step 5: Complete the set up
You've successfully connected your Linear account. Click Continue to complete the setup and start using the connector.
Known limitations
Issue status: The connector can read the current status of an issue but cannot change it.
Projects: The connector cannot update or delete projects. Listing exposes only key fields (id, name, lead, status, progress, url). Project creation only sets team, name, and description.
Search: Teams and projects can only be listed — no filtered search. Issue search is limited to filtering by team, project, assignee, label, and title.
Users: The connector cannot look up users by name or email — only by ID.