> ## Documentation Index
> Fetch the complete documentation index at: https://docs.markifact.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Schedule

> Triggers the workflow on a schedule (daily, weekly, monthly, or custom intervals)

Triggers the workflow on a schedule (daily, weekly, monthly, or custom intervals). The trigger automatically uses the user's timezone from their profile settings, which is based on their location. No timezone selection is needed.

| | |
| - | - |
| **App** | Scheduler |
| **Operation ID** | `scheduler_schedule` |
| **Type** | Trigger |
| **Connection** | None |
| **Credits per run** | Free |

## Inputs

| Field | Type | Required | Default | Description |
| - | - | - | - | - |
| `interval` | string or SelectableOption | Yes | - | The frequency interval for the schedule. Available options:                    'hourly' - Runs every X hours (requires upgrade for free users)                    'daily' - Runs once daily at specified time                    'weekly' - Runs weekly on specified day and time                    'monthly' - Runs monthly on specified day and time                    'minutely' - Runs every X minutes (requires premium tier)                    'once' - Runs once at specified datetime |
| `minutes` | integer | No | - | Run workflow every X minutes (1-59). Only used when interval is 'minutely'. Premium users can use values less than 15 minutes, others require 15+ minutes. |
| `hours` | integer | No | - | Run workflow every X hours (1-23). Only used when interval is 'hourly'. Not available for free tier users. |
| `hour_offset` | string or SelectableOption | No | - | Minute offset for hourly schedules. Only used when interval is 'hourly'. Available options:                    '0' - Runs at XX:00                    '15' - Runs at XX:15                    '30' - Runs at XX:30                    '45' - Runs at XX:45 |
| `run_time` | string or SelectableOption | No | - | Time of day to run the schedule in HH:MM format (e.g., '14:30' for 2:30 PM). Only used for daily, weekly, and monthly intervals. Available in 30-minute increments. |
| `days` | array of string | No | - | List of days of the week when the schedule should run. Only used when interval is 'daily'.                    Empty array or None means run every day. Values should be strings: '0' (Sunday) through '6' (Saturday).                    Example: \['1', '2', '3', '4', '5'] for weekdays only. |
| `week_day` | string or SelectableOption | No | - | Day of the week for weekly schedules. Only used when interval is 'weekly'. Available options:                    '0' - Sunday                    '1' - Monday                    '2' - Tuesday                    '3' - Wednesday                    '4' - Thursday                    '5' - Friday                    '6' - Saturday |
| `week_interval` | integer | No | `1` | Run every N weeks when interval is 'weekly'. Use 1 for weekly or 2 for every other week. |
| `anchor_date` | string | No | - | Internal local YYYY-MM-DD anchor for weekly schedules with week\_interval greater than 1. |
| `month_day` | string or SelectableOption | No | - | Day of the month for monthly schedules (1-31). Only used when interval is 'monthly'. If the selected day doesn't exist in a month, it will run on the last day of that month. |
| `once_time` | integer or string | No | - | Specific date and time to run the workflow once. Only used when interval is 'once'. Must be at least 15 minutes in the future from the current time. |

### SelectableOption

| Field | Type | Required | Default | Description |
| - | - | - | - | - |
| `value` | string | Yes | - | |
| `label` | string | Yes | - | |

## Output

**Type**: `Dict`

Returns date/time context for the scheduled run.

**Fields**: `today_date`, `yesterday_date`, `day_of_week`, `day_of_week_number`, `current_month`, `current_month_name`, `current_month_name_year`, `current_month_start_date`, `current_month_end_date`, `last_month`, `last_month_name`, `last_month_name_year`, `last_month_start_date`, `last_month_end_date`, `current_year`, `last_year`, `current_week_start_date`, `current_week_end_date`, `current_week_number`, `previous_week_start_date`, `previous_week_end_date`, `previous_week_number`


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.