Create an agent trigger
Create a schedule or webhook trigger.
A schedule takes exactly one of cron_expression (recurring, five-field cron) or run_at (one time, ISO 8601). timezone defaults to the caller’s profile timezone. A webhook takes prompt and returns webhook_url in this response only; the URL embeds the trigger’s secret, so store it or fetch it again from the reveal endpoint.
Connector-event triggers and agent-built triggers cannot be created here. Team API keys are not accepted: a trigger runs later on the creating member’s credentials.
Authorizations
Path Parameters
ID of a custom agent.
Body
schedule, webhook The message the agent receives when the trigger fires.
Label shown in the triggers list.
Schedule only. Five-field cron, e.g. 0 9 * * 1-5.
Schedule only. One-time run; must be in the future. Interpreted in timezone when it has no offset.
Schedule only. IANA name. Defaults to the caller's profile timezone.
Webhook only. Forward the request body to the agent instead of prompt.
Consecutive failures before the trigger disables itself. Defaults to 3 (1 for one-time runs).
Response
The created trigger. For a webhook, webhook_url is populated here only.