Linear

Connect Linear so Clearly AI can read Linear issues as Project sources and use Linear in Workflows.

The Linear integration supports:

• OAuth 2.0 with Linear read and write access.
• Personal Token authentication.

Connect Linear

1. In Clearly AI, open Integrations and select Linear.
2. Choose an authentication method.
3. For OAuth 2.0, on the Integrations page choose Personal (User) or Shared (Workspace), then click Connect with Linear.
4. For Personal Token, paste the token in Personal Key.
5. Save and test the connection.

Use Personal (User) when only you should use the Linear connection. Use Shared (Workspace) when the connection should be shared by the Clearly AI organization.

Add a Linear issue as a source

1. Open a Project.
2. Open Manage Sources and click Search Integrations.
3. Select Linear.
4. Confirm the workspace. Linear tokens are scoped to one workspace.
5. Enter the issue ID, such as ENG-123.
6. Save the source.

Clearly AI fetches the issue title, description, status, priority, labels, team, project, assignee, comments, sub-issues, and attachments when available.

Use Linear in Workflows

Linear Workflow support includes:

• Linear Issue Created or Updated trigger, with optional label and team filters.
• Create Linear Ticket.
• Assign Linear Ticket.
• Create Linear Comment.
• Attach Review Export to Linear Ticket.

To use the trigger, configure the Linear webhook in Clearly AI and in Linear. Linear webhooks are configured from Settings > API and should send Issue events to the Clearly AI webhook URL.

The Clearly AI webhook settings include:

• Webhook URL: paste this into the Linear webhook configuration.
• Signing Secret: paste the signing secret from the Linear webhook detail page so Clearly AI can verify the Linear-Signature header.
• Workspace Slug: the URL key from linear.app/<workspace-slug>.

FAQs

Related

• Integrations
• Workflows