Schedule Triggers

Schedule triggers run your agents at specific times—daily, weekly, or on custom intervals.

Setting Up a Schedule

Open Agent Settings

Go to your agent and click "Edit" or create a new agent.

Select Schedule Trigger

In the Trigger section, choose "Schedule."

Choose Frequency

Select how often the agent should run:

Every X minutes
Every X hours
Daily
Weekly
Monthly
Custom cron expression

Set Time

For daily/weekly/monthly, specify the exact time.

Select Timezone

Choose your timezone to ensure the agent runs when you expect.

Schedule Options

Quick Intervals

Option	Runs
Every 30 minutes	48 times per day
Every hour	24 times per day
Every 6 hours	4 times per day
Every 12 hours	Twice per day

Daily Schedule

Run once per day at a specific time:

Time: 8:00 AM
Timezone: America/New_York

Weekly Schedule

Run on specific days of the week:

Days: Monday, Wednesday, Friday
Time: 9:00 AM
Timezone: America/Los_Angeles

Monthly Schedule

Run on specific days of the month:

Day: 1st of each month
Time: 6:00 AM
Timezone: UTC

Custom Cron

For advanced users, use cron expressions:

Expression: 0 9 * * 1-5
Meaning: At 9:00 AM, Monday through Friday

Common Schedule Patterns

Morning Digest

Frequency: Daily
Time: 7:00 AM
Timezone: Your local time

Perfect for daily email summaries, news digests, or morning briefings.

End of Day Report

Frequency: Daily
Time: 5:00 PM
Days: Monday-Friday

Generate daily reports at the end of each workday.

Weekly Review

Frequency: Weekly
Day: Friday
Time: 4:00 PM

Create weekly summaries or review tasks.

Hourly Monitor

Frequency: Every hour

Check for important changes throughout the day.

Cron Expression Reference

For complex schedules, use cron expressions:

┌───────────── minute (0 - 59)
│ ┌───────────── hour (0 - 23)
│ │ ┌───────────── day of month (1 - 31)
│ │ │ ┌───────────── month (1 - 12)
│ │ │ │ ┌───────────── day of week (0 - 6, Sunday = 0)
│ │ │ │ │
* * * * *

Examples

Cron Expression	Meaning
`0 9 * * *`	Every day at 9:00 AM
`0 9 * * 1-5`	Weekdays at 9:00 AM
`0 /2 * *`	Every 2 hours
`30 8 1 * *`	8:30 AM on the 1st of each month
`0 9,17 * * *`	9:00 AM and 5:00 PM daily

Timezone Handling

Important: Always set your timezone explicitly. Schedules use UTC by default.

Billix supports all standard timezones:

America/New_York
America/Los_Angeles
Europe/London
Europe/Paris
Asia/Tokyo
Australia/Sydney
And many more

Daylight Saving Time

Billix automatically handles DST transitions:

Spring forward: Agent may skip the "lost" hour
Fall back: Agent won't run twice during the repeated hour

Missed Runs

If a scheduled run is missed (server issue, etc.):

Billix attempts to run as soon as possible
Only one "catch-up" run happens (not all missed runs)
You'll see "Delayed" status in the run history

Multiple Schedules

Add multiple schedules to one agent:

Add First Schedule

Set up your primary schedule.

Click "Add Another Schedule"

Add additional triggers.

Configure Each

Each schedule can have different times/frequencies.

Example: Run at 8 AM and 5 PM daily

Schedule 1: Daily at 8:00 AM
Schedule 2: Daily at 5:00 PM

Pausing Schedules

Temporarily disable a schedule without deleting:

Go to agent settings
Toggle "Pause Schedule" on
The agent won't run until you un-pause

Useful for:

Vacation periods
Testing changes
Temporary maintenance

Viewing Schedule Status

Check when your agent will run next:

Go to the agent's detail page
See "Next Run" in the status section
View past runs in the History tab