Quickstart Guide
This guide walks you through creating your first scheduled job in under five minutes.
Step 1: Create a Job
Navigate to Jobs in the sidebar and click New Job.
| Field | Example |
|---|---|
| Name | my-api-ping |
| Type | http |
| URL | https://httpbin.org/get |
| Method | GET |
| Timeout | 30 seconds |
Click Create to save the job.
Step 2: Create a Schedule
Navigate to Schedules and click New Schedule.
| Field | Example |
|---|---|
| Job | Select my-api-ping |
| Cron Expression | */5 * * * * (every 5 minutes) |
| Timezone | America/New_York |
| Misfire Policy | latest_only |
Click Create. The schedule's next run time will be calculated automatically.
Step 3: Monitor Executions
Go to Executions to see your job running. Each execution shows:
- Status — pending, running, success, failure, or timeout
- Duration — how long the execution took
- Status Code — the HTTP response code (for HTTP jobs)
- Scheduled For — when the execution was supposed to run
- Started At / Completed At — actual timing
Step 4: Trigger Manually
You can trigger a job immediately without waiting for the schedule:
- Go to Jobs and find your job.
- Click the Trigger button.
- A new execution will appear with trigger type
manual.
Step 5: Set Up an Alert
Navigate to Alerts > Rules and click New Rule.
| Field | Example |
|---|---|
| Job | Select my-api-ping |
| Condition | consecutive_failures |
| Threshold | 3 |
| Cooldown | 60 minutes |
Save the rule, then navigate to Alerts > Subscriptions and click New Subscription. Select the rule.fired event type, optionally filter to my-api-ping, add a notification channel, and save. You'll be notified after 3 consecutive failures.
Next Steps
- Learn about all the job types and their configuration options.
- Explore cron expressions and misfire policies in depth.
- Set up roles and permissions for your team.
- Install the CLI tool for command-line management.