Skip to main content
The official Linear integration lets your bot automate issue workflows and react to repository file events.

Setup

You will need:
1
In Botpress Studio, select Explore Hub in the upper-right corner.
2
Search for the Linear integration, then select Install Integration.
3
In the Configuration menu, select Authorize Linear.
4
Follow the on-screen instructions to connect Botpress to your Linear workspace.
When using this configuration mode, Botpress connects to Linear using OAuth. Actions taken by the bot use the Linear account that completed authorization.If you need an API key, webhook signing secret, or more control over how Linear sends events to Botpress, use Manual configuration instead.

Cards

Here’s a reference for all Cards available with the integration:

Create Issue

Delete Issue

object
This Card has no output.

Find Target

object
object

Get Issue

Get or Create a Conversation

Get User Profile

Issue Delete

object
This Card has no output.

Issue List

object

List Issues

List States

List Teams

object
This Card has no input fields.

List Users

Mark Issue as Duplicate

object
This Card has no output.

Resolve Comment

Send Raw GraphQL Query

Update Issue


Triggers

Here’s a reference for all Triggers available with the integration:
You can access data returned from any of these Triggers by reading event.payload after the Trigger fires.

Aggregate File Changes

object

File Created

object

File Deleted

object

File Updated

object

Folder Deleted Recursive

object

Issue Created

Issue Deleted

Issue Updated

Last modified on June 15, 2026