GitHub Webhooks

GitHub webhooks let agents respond to repository events like issues, pull requests, and pushes.

Filter Fields (all optional)

Field	Type	Description
`repos`	string[]	Only trigger for these repos
`orgs`	string[]	Only trigger for these organizations
`org`	string	Only trigger for this organization (singular form)
`events`	string[]	GitHub event types (issues, pull_request, push, etc.)
`actions`	string[]	Event actions (opened, labeled, closed, etc.)
`labels`	string[]	Only when issue/PR has these labels
`assignee`	string	Only when assigned to this user
`author`	string	Only for this author
`branches`	string[]	Only for these branches
`conclusions`	string[]	Only for workflow_run events with these conclusions (success, failure, cancelled, skipped, timed_out, action_required)

In your GitHub repo, go to Settings > Webhooks > Add webhook
Set the payload URL to your Action Llama gateway (e.g. https://your-server:8080/webhooks/github)
Set content type to application/json
Set the secret to match the github_webhook_secret credential instance referenced by the webhook source in config.toml
Select the events you want to receive

ngrok http 8080

Use the ngrok URL as your webhook payload URL in GitHub. See Using Webhooks for a full tutorial.

# In project config.toml
[webhooks.my-github]
type = "github"
credential = "MyOrg"

# In agents/<name>/config.toml
[[webhooks]]
source = "my-github"
repos = ["acme/app"]
events = ["issues"]
actions = ["labeled"]
labels = ["agent"]