# Schedule a workflow run

Source: https://neondeerdata.com/docs/platform/automations/steps/schedule-workflow-run/

Step · Scheduled workflows

Schedules a record to enter a workflow at a chosen date and time.

[Scheduled workflow setup and monitoring](https://neondeerdata.com/docs/platform/automations/attio-scheduled-workflows/)

## 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](https://neondeerdata.com/docs/platform/automations/troubleshooting/).

## Example

Schedule a follow-up workflow for a company at the time chosen by your team.

**Example inputs**

| Input    | Value                  |
| -------- | ---------------------- |
| Object   | Companies              |
| Workflow | Renewal follow-up      |
| Run at   | A future date and time |
| Record   | Acme Corp (Companies)  |

**Example outputs**

| 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.