The Linear integration in Ruut allows you to seamlessly convert customer conversations into actionable tasks in your Linear workspace. With this integration, your support team can quickly escalate bugs, feature requests, or feedback to your product team—without ever leaving Ruut.
What Can You Do with the Linear Integration?
-
Create new issues in Linear directly from a Ruut conversation
-
Link existing Linear issues to ongoing customer threads
-
Track issue progress from within Ruut
-
Keep your support and product teams aligned
✅ Prerequisites
Before you begin, make sure:
-
You have a Ruut account with Admin privileges.
-
You have a Linear account with access to the workspace you want to connect.
-
Your Ruut workspace supports integrations (check with your Ruut plan if unsure).
🔧 How to Connect Linear with Ruut
-
Navigate to application in Ruut:
-
Go to your Ruut dashboard
-
Click on Settings > Application
-
Select Linear from the list
-
-
Authorize Access:
-
Click on Connect Linear
-
A dialog would appear to enter your API Key
-
Go to your linear dashboard and locate the settings
-
Look for Security and access > and generate a Personal API key
-
Copy the generated API key to Ruut
-
-
Complete Setup:
-
Save your settings
-
You’ll now see the Linear integration as “Enabled”
-
Go to your conversation next you should see the Linear icon as described in the image below
-
🛠 How to Use the Integration
🔹 Create a New Issue from a Ruut Conversation
-
Open any customer conversation in Ruut
-
Click the Linear logo
-
A modal pops up to either add a new issue or link an existing issue to a particular conversation:
-
Click Create
📝 The Linear issue will now be linked to the conversation. A note will be added so all team members can see the connection.
🔗 Link to an Existing Linear Issue
-
In a Ruut conversation, click on More actions > Link Linear Issue
-
Search for the existing issue by name or ID
-
Select and confirm
This is useful for when multiple customers are reporting the same problem.
👀 Track Issue Status
Once an issue is linked, you can:
-
View issue status and updates directly within Ruut
-
Click through to view the issue in Linear
-
Stay informed about when an issue is closed or updated
🙋 Common Use Cases
-
Escalate bugs reported by customers
-
Track feedback for product improvements
-
Keep customer support and product teams in sync
-
Avoid duplicate reports by linking to existing Linear issues
📌 Final Notes
The Ruut + Linear integration helps you streamline internal workflows and deliver better experiences to customers. No more toggling between tools—everything happens in context.
Need help? Contact support or reach out to your Ruut success manager.