Overview

Triggers fire agent workflows without manual input. Use cron‑like schedules, incoming webhooks, or integration events to kick off work reliably.

Trigger types

• Schedule: run every N minutes, hourly, daily, or with cron.
• Webhook: POST a payload to a unique URL to start a run.
• App events: respond to provider events (e.g., new file, new row).

Inputs and mapping

• Define expected inputs for the agent or playbook.
• Map webhook JSON fields or event properties into inputs.
• Provide defaults and validation to prevent bad runs.

Schedules

• Supports presets and custom cron expressions.
• Time zones and daylight savings handled automatically.
• Backoff and retry policies configurable per trigger.

Webhooks

• Each trigger gets a unique HTTPS endpoint.
• Send JSON with an Authorization header or secret token.
• Validate signatures for supported providers.

Security

• Rotate webhook secrets regularly; never commit them to code.
• Rate‑limit incoming events to protect agents.
• Use allowlists for IPs if integrating with internal systems.

Monitoring and retries

• View recent trigger deliveries with status and latency.
• Replay failed deliveries; inspect payload and error message.
• Configure dead‑letter queues for persistent failures.