Skip to main content

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