Linear Integration

Zephyr documentation

How Linear Integration Works

Zephyr can create Linear issues as a workflow action using OAuth 2.0. When a workflow triggers, the linear_issue action creates an issue in your chosen Linear team with the email content or AI-processed result as the description. This is great for turning bug report emails or feature request emails into tracked issues without leaving Outlook.

Setting Up Linear

1) Go to linear.app/settings/api/applications/new and create a new OAuth application.

2
Set the callback URL to your Zephyr API URL + /connectors/linear/callback.
3
Copy the Client ID and Client Secret.
4
Add them as SSM parameters: /zephyr/prod/linear-client-id and /zephyr/prod/linear-client-secret.
5
Deploy Zephyr.
6
In Settings > Connected Services, click Connect on the Linear card and authorize in the browser window that opens.

Creating Linear Workflows

Example: 'When I get a bug report email, summarize it and create a Linear issue'. The AI generates a workflow with ai.summarize followed by linear_issue. You need your Linear Team ID, which you can find in Linear under Settings > API > Team ID. You can also set a priority (urgent, high, medium, or low) on the action.

Finding Your Team ID

In Linear, go to Settings > API. Your Team ID is listed under the Teams section. It is a short alphanumeric string. Copy it and paste it into the Team ID field when configuring the linear_issue action in the WorkflowBuilder.