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

​
Filter Fields (all optional)

FieldTypeDescription
organizationsstring[]Only trigger for these Linear organizations
eventsstring[]Linear event types (issues, issue_comment, etc.)
actionsstring[]Event actions (create, update, delete, etc.)
labelsstring[]Only when issue has these labels
assigneestringOnly when assigned to this user (email)
authorstringOnly 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

# In project config.toml
[webhooks.linear-main]
type = "linear"
credential = "main-workspace"

# 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"]