Documentation Index Fetch the complete documentation index at: https://docs.guild.ai/llms.txt
Use this file to discover all available pages before exploring further.
A trigger runs an agent automatically — either when an event occurs in an external service, or on a recurring schedule.
Trigger types
Webhook Fires when an event occurs in a connected service, such as a new Slack mention or a GitHub pull request.
Time Fires on a recurring schedule: hourly, daily, weekly, or monthly.
Create a trigger
Open your workspace
Go to guild.ai and open the workspace where the agent is installed.
Go to Triggers
Click Triggers in the left sidebar, then click New trigger .
Choose a type
Select Webhook or Time , then configure the trigger.
Select an agent
Choose the agent the trigger will run when it fires.
Webhook triggers A webhook trigger fires when a specific event occurs in a connected service.
Supported services Service Example events Slack app_mention, messageGitHub pull_request, issues, pushLinear issue, commentJira issue_created, issue_updatedBitbucket pullrequest:created, issue:createdAzure DevOps workitem.created, git.pullrequest.createdGoogle Docs Document changes Notion Page updates
Configure the service, event type, and optional event action when creating the trigger. The agent receives the event payload as its input.
CLI # Create a Slack webhook trigger guild trigger create \ --type webhook \ --service SLACK \ --event app_mention \ --agent slack-assistant # Create a GitHub webhook trigger for opened pull requests guild trigger create \ --type webhook \ --service GITHUB \ --event pull_request \ --action opened \ --agent code-reviewer
Time triggers A time trigger fires on a recurring schedule and runs the agent with a fixed input.
Frequencies Frequency Options HOURLY— DAILYTime of day WEEKLYDays of week, time of day MONTHLYDays of month, time of day
CLI # Daily trigger at 9:00 AM guild trigger create \ --type time \ --frequency DAILY \ --time 09:00 \ --agent daily-report \ --input '{"project": "GUILD"}' # Weekly trigger on Monday mornings guild trigger create \ --type time \ --frequency WEEKLY \ --days-of-week monday \ --time 09:00 \ --agent weekly-summary
Manage triggers Activate and deactivate Deactivate a trigger to pause it without deleting it.
guild trigger deactivate < trigger-i d > guild trigger activate < trigger-i d >
List and inspect # List all triggers in the workspace guild trigger list # Get details for a specific trigger guild trigger get < trigger-i d > # List sessions spawned by a trigger guild trigger sessions < trigger-i d >
Update # Change the schedule of a time trigger guild trigger update < trigger-i d > --time 10:00 # Change the event of a webhook trigger guild trigger update < trigger-i d > --event message
