Automation overview - Flow

An automation combines instructions with a trigger. Configure it in Flow, send an event, and use the API to track the resulting runs.

Choose a trigger

Trigger	Use it for
Custom webhook	Events from your own tools, identified by a webhook name.
API endpoint	Automations configured with the `endpoint` source.
Connected app	Events from an app connected to Flow, such as GitHub or Slack.
Branch review	Checks and actions associated with a Flow branch review.

Integrations connect external apps to Flow. Automations define the work Flow runs when an event arrives.

Set up and run

Set up a webhook automation: configure its instructions and name, then send a JSON event.
Trigger and poll automations: start runs asynchronously, store their IDs, and read the results.
Use the endpoint reference for complete request and response schemas.

A trigger request matches automations by source. One request can start multiple runs. Include project_id to target the intended project, and track each returned agent_id separately.

Automation endpoints

All automation endpoints remain in Endpoints. These guides explain how to use them together.