Receiver-idempotent
Automatic retries favor delivery. Deduplicate on the supplied Idempotency-Key.
Durable scheduled event delivery
The clock calls.Your endpoint answers.
Create a one-time, interval, or cron schedule. jscheduler holds the state, fires on the minute, and keeps delivering your HTTP webhook until it has a real answer.
No SDK requiredUTC · minute precisionIdempotency keys included
Dispatch tracelive
MON / 13 JULUTC
invoice.reminderqueued
invoice.reminderclaimed · worker-03
POST /hooks/billing202 · 184ms
trial.expiringnext dispatch
ONE-TIME01INTERVAL02CRON03HTTP OUTBOX04AUTOMATIC RETRY05MANUAL REDRIVE
The mechanism / 04 moves
Small control plane.
Serious delivery path.
Scheduling and sending are separate jobs. PostgreSQL leases make workers safe to scale horizontally; a durable outbox keeps a slow or failing receiver from blocking the clock.
- 01
Define
Send JSON with a name, payload, and schedule. The API validates minute precision before storing it.
- 02
Claim
A worker atomically leases due work with
SKIP LOCKED, so more workers add capacity without double-claiming. - 03
Dispatch
The occurrence enters an HTTP outbox, then routes to your default or tag-specific endpoint.
- 04
Prove
Inspect attempts and errors, rely on the occurrence id for deduplication, and redrive uncertain delivery.
First dispatch / about two minutes
Three commands.
Then watch your server.
Access gives you an organization and an API key. The same key works in the CLI and plain HTTP—there is no proprietary runtime to install.
Open the complete quickstart →FIRST-RUN.SHzsh
01
$
curl -fsSL https://cli.jscheduler.com/install.sh | bash02
$
jscheduler auth login --api-key jsk_••••••03
$
jscheduler endpoints create --url https://example.com/hooks04
$
jscheduler events create --name wake-up --kind ONE_TIME \\--fire-at 2030-07-13T09:00:00Z --payload '{"ready":true}'✓ Event created · next fire 2030-07-13 09:00 UTC
Delivery discipline
Built to keep the appointment.
The hot path is database-backed and lease-coordinated. Every delivery gets history, attempt state, and an idempotency key—useful evidence when a receiver has a bad day.
3default HTTP attemptsexponential backoff
4×native CLI targetsmacOS + Linux · arm64 + x64
No-duplicate-sends
Ambiguous network outcomes stop as UNCERTAIN and wait for your explicit redrive.
Schedule vocabulary
At one exact minute.
2030-07-13T09:00:00ZReminders, trial endings, delayed workflows.
Every N minutes.
intervalMinutes: 15Polling, refreshes, recurring maintenance.
On a UTC calendar.
0 9 * * MON-FRIReports, billing cycles, business routines.
READY
TO
DISPATCH
TO
DISPATCH
Next minute is coming