With the Linear integration, you can easily create and link Linear issues directly from a conversation without ever leaving Groove. When an issue is updated in Linear, you'll see those updates reflected in Groove, helping your support and engineering teams stay in sync.

#Connecting your Linear account

To add the integration to your Groove account, navigate to Settings → Integrations and click Connect for the Linear integration. In the configuration window, click Install App.



You'll be prompted to sign in to your Linear workspace and authorize Groove to access your account.



#Configuring the integration

Once connected, you can configure the options available in the Linear sidebar.



#Link an existing issue

To link an existing Linear issue, simply search for the issue by its title or issue ID and attach it to the current conversation.

#Create a new issue

When creating a new Linear issue from Groove, you can specify the following details:

• Title
• Team
• Project (optional)
• Workflow state
• Assignee (optional)
• Priority (optional)
• Labels (optional)
• Description (optional)

After saving, the issue will be created in Linear and automatically linked to the conversation.

#Using the Linear sidebar

Open any conversation in your inbox and you'll find the Linear integration in the right-hand sidebar.



Once an issue has been linked or created, you'll see a direct link to the issue, along with its current status and other relevant details.

As the issue progresses in Linear, updates such as status changes, comments, assignments, and completion will appear as activity within the conversation timeline. You can also configure specific Linear events to automatically reopen conversations when action is required.



#Integration settings

Settings for the Linear integration are managed at the account level. Any configuration changes made to the integration will apply to all users in your Groove account.

Automation actions configured for the integration are also shared across the account, allowing all agents to benefit from consistent workflows.

#Troubleshooting

#Unable to connect to Linear?

If you're having trouble connecting your Linear workspace:

• Verify that you have permission to install applications for your Linear workspace.
• Ensure you're signing in to the correct Linear workspace if you belong to multiple organizations.
• If authorization fails, disconnect the integration from Groove and reconnect it to refresh the permissions.
• If the issue persists, contact Groove Support with any error messages you receive during the authorization process.