Start agents manually, on a schedule or from a webhook

Triggers decide how an agent starts. Every agent can be run by hand. You can add a schedule, a webhook, or both.

Run it manually

1. Open the agent.
2. In Run now, optionally type an Input.
3. Choose Run agent. You are taken to the run's page. The button is disabled while the agent is paused.

Run on a schedule

1. Under Triggers, tick On a schedule.
2. Under Repeats, choose Every hour, Every day, Weekdays, Every week, Every month or Custom (cron).
3. Set the details that appear: Day, Day of month (1 to 28), Hour (0-23) and Minute (0-59).
4. Pick a Time zone.
5. Optionally fill in Input for scheduled runs.
6. Choose Save changes.

A sentence under the form describes the schedule in words, and Next run shows when it will fire. With Custom (cron) you type five fields (minute hour day month weekday); an invalid expression stops you saving. A schedule can fire at most once every 5 minutes.

Run when a web address is called

1. Tick When a web address is called (webhook).
2. Choose Save changes. The Webhook URL (POST) appears.
3. Use Show to reveal it and Copy to copy it.

Send a POST request to that address and the request body becomes the run's input. The call is answered at once with a run id; the work happens in the background. The payload is handed to the agent labelled as untrusted data.

Keep it private. Anyone with the address can start a run. If it leaks, choose Rotate secret and confirm. The old address stops working immediately.

Webhook calls are rate limited per agent. Too many wrong addresses from one place are blocked for a while.

Pause an agent

Choose Pause (then save) in the page header and then Save changes. A paused agent shows a warning banner and its schedules and webhooks do not start runs. Use Resume (then save) to turn it back on.

Good to know

• An agent added from Marketplace with a schedule starts paused so you can review it.
• Concurrent runs are limited: up to 5 active runs per agent and 20 per account.
• You can watch the next scheduled run live from the agent's Recent runs panel. See Runs and the live trace.