Step · Scheduled workflows
Schedule a workflow run
Schedules a record to enter a workflow at a chosen date and time.
Scheduled workflow setup and monitoring
Inputs
| Label | Key | Type | Required | Notes |
|---|---|---|---|---|
| Object | object | Object | Yes | |
| Workflow | workflow_id | Workflow | Yes | An active workflow starting with Start a scheduled run for the selected object. |
| Run at | run_at | Timestamp | Yes | |
| Record | record | Record | Yes |
Outputs
| Label | Key | Type | Always set | Notes |
|---|---|---|---|---|
| Scheduled run ID | scheduled_run_id | Text | Yes | |
| Scheduled for | scheduled_for | Timestamp | Yes | The time accepted for the scheduled run; use this output to check when it is due. |
How it behaves
- The destination workflow must start with Start a scheduled run for the same object.
- The step schedules the record for later; it does not wait for the target workflow to finish.
- Review the returned scheduled time and monitor the run in Automations → Scheduled runs.
Errors
Fails when
- Check the organization time zone, active workflow, selected object, and record.
- Scheduling requires the app connection and a plan that includes scheduled runs.
For errors that every step can return, see Troubleshooting.
Example
Schedule a follow-up workflow for a company at the time chosen by your team.
| Input | Value |
|---|---|
| Object | Companies |
| Workflow | Renewal follow-up |
| Run at | A future date and time |
| Record | Acme Corp (Companies) |
| Output | Value |
|---|---|
| Scheduled run ID | The ID of the scheduled run |
| Scheduled for | The accepted date and time |
Use the returned scheduled time and check the run in Automations → Scheduled runs.