> ## Documentation Index
> Fetch the complete documentation index at: https://docs.actionllama.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Linear Webhooks

> Filter fields, setup, and examples for Linear webhook triggers

Linear webhooks let agents respond to issue and comment events in your Linear workspace.

## Filter Fields (all optional)

| Field           | Type      | Description                                       |
| --------------- | --------- | ------------------------------------------------- |
| `organizations` | string\[] | Only trigger for these Linear organizations       |
| `events`        | string\[] | Linear event types (issues, issue\_comment, etc.) |
| `actions`       | string\[] | Event actions (create, update, delete, etc.)      |
| `labels`        | string\[] | Only when issue has these labels                  |
| `assignee`      | string    | Only when assigned to this user (email)           |
| `author`        | string    | Only for this author (email)                      |

## Setup

1. In Linear, go to **Settings > Workspace > Webhooks**
2. Click **Create webhook**
3. Set the URL to your Action Llama gateway (e.g. `https://your-server:8080/webhooks/linear`)
4. Set the secret to match the `linear_webhook_secret` credential instance referenced by the webhook source in `config.toml`
5. Select the resource types you want to receive (Issues, Comments, etc.)

## Example Configuration

```toml theme={null}
# In project config.toml
[webhooks.linear-main]
type = "linear"
credential = "main-workspace"
```

```toml theme={null}
# In agents/<name>/config.toml
[[webhooks]]
source = "linear-main"
events = ["issues", "issue_comment"]
actions = ["create", "update"]
organizations = ["your-org-id"]
labels = ["bug", "ready-for-dev"]
```