Linear

Connect your bot to Linear using the official integration.

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

Setup

Basic configuration

You will need:

• A published bot
• A Linear account with access to the workspace you want to connect

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.

Manual configuration

For advanced use cases, you can configure the integration with a Linear API key and Webhook Signing Secret instead of OAuth.

You will need:

• A published bot
• A Linear account with access to the workspace you want to connect

Creating a Linear API key

1. On Linear, navigate to your account settings and select the API tab in the navigation sidebar.

2. Under Personal API keys, enter a name for your API key and select Create new API key.

3. 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

1. In Botpress, open the Configuration page for the Linear integration.

2. Copy the Webhook URL generated by Botpress.

3. On Linear, go to your account settings and select the API tab in the navigation sidebar.

4. Under Webhooks, select Create new webhook.

5. Enter a name for the webhook and paste the webhook URL from Botpress into the URL field.

6. Copy the webhook signing secret and store it in a secure location. You will need it to configure the Linear integration in Botpress.

7. 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.
8. Under Teams, select the teams you want to receive notifications for.

9. Select Create webhook to save your changes.

Configuring the Linear integration in Botpress

1. In Botpress, open the Configuration page for the Linear integration.

2. Select Configure Linear with an API Key.

3. Enter the API key from Linear in the API Key field.

4. Enter the webhook signing secret from Linear in the Webhook Signing Secret field.

5. 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

output · object

This Card has no output.

Find Target

input · object

Show child attributes

channel · enum<string> · required

Available options: issue

output · object

Show child attributes

targets · array · required

Show array item properties

channel · enum<string> · required

Available options: issue

Get Issue

Get or Create a Conversation

Get User Profile

Issue Delete

output · object

This Card has no output.

Issue List

output · object

Show child attributes

items · array · required

List Issues

List States

List Teams

input · object

This Card has no input fields.

List Users

Mark Issue as Duplicate

output · 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

payload · object

Show child attributes

modifiedItems · object · required

Show child attributes

created · array · required

Show array item properties

type · string · required

updated · array · required

Show array item properties

type · string · required

deleted · array · required

file

Show child attributes

type · string · required

folder

Show child attributes

type · string · required

File Created

payload · object

Show child attributes

file · object · required

Show child attributes

type · string · required

File Deleted

payload · object

Show child attributes

file · object · required

Show child attributes

type · string · required

File Updated

payload · object

Show child attributes

file · object · required

Show child attributes

type · string · required

Folder Deleted Recursive

payload · object

Show child attributes

folder · object · required

Show child attributes

type · string · required

Issue Created

Issue Deleted

Issue Updated