The official Linear integration lets your bot automate issue workflows and react to repository file events.
Setup Basic configuration
Manual configuration
In Botpress Studio, select Explore Hub in the upper-right corner.
Search for the Linear integration, then select Install Integration .
In the Configuration menu, select Authorize Linear .
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. For advanced use cases, you can configure the integration with a Linear API key and Webhook Signing Secret instead of OAuth. Creating a Linear API key
On Linear, navigate to your account settings and select the API tab in the navigation sidebar.
Under Personal API keys , enter a name for your API key and select Create new API key .
Save this API key in a secure location. You will need it to configure the Linear integration in Botpress. Treat API keys like passwords. Store them securely and rotate them if they’re exposed.
Subscribing to Linear webhook events
In Botpress, open the Configuration page for the Linear integration.
Copy the Webhook URL generated by Botpress.
On Linear, go to your account settings and select the API tab in the navigation sidebar.
Under Webhooks , select Create new webhook .
Enter a name for the webhook and paste the webhook URL from Botpress into the URL field.
Copy the webhook signing secret and store it in a secure location. You will need it to configure the Linear integration in Botpress.
Under Data change events , choose the events to subscribe to:
Issues : Receive notifications when issues are created, updated, or deleted.Comments : Receive notifications when comments are added to issues.
Under Teams , select the teams you want to receive notifications for.
Select Create webhook to save your changes.
Configuring the Linear integration in Botpress
In Botpress, open the Configuration page for the Linear integration.
Select Configure Linear with an API Key .
Enter the API key from Linear in the API Key field.
Enter the webhook signing secret from Linear in the Webhook Signing Secret field.
Save the configuration and enable the integration.
Your Linear integration is ready. Use the Cards and Triggers sections below to build your workflows.
Cards Here’s a reference for all Cards available with the integration:
Create Issue Delete Issue Find Target Show array item properties
Get Issue Get or Create a Conversation Get User Profile Issue Delete Issue List List Issues List States List Teams This Card has no input fields.
List Users Mark Issue as Duplicate 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 Show array item properties
Show array item properties
File Created File Deleted File Updated Folder Deleted Recursive Issue Created Issue Deleted Issue Updated 
