Primitives Scheduler
Scheduler API
Run tasks at the right time. Schedule one-off or recurring invocations — no workers to run, no infrastructure to manage.
Schedule (at / interval) RocketStack Your webhook at that time
Quickstart
Schedule a task and have it execute at the exact time you specify.
1. Create a schedule
Specify when to run and where to deliver.
POST https://api.rocketstack.dev/schedules
{
"name": "reminder",
"runAt": "2025-02-15T09:00:00Z",
"deliveryTarget": {
"type": "webhook",
"webhookUrl": "https://yourapp.com/reminder"
}
}2. Add payload (optional)
Include context data to pass to your webhook.
POST https://api.rocketstack.dev/schedules
{
"name": "reminder",
"runAt": "2025-02-15T09:00:00Z",
"deliveryTarget": {
"type": "webhook",
"webhookUrl": "https://yourapp.com/reminder"
},
"payloadTemplate": { "userId": "usr_456" }
}3. Receive invocation
Your webhook is called at the scheduled time.
// At 2025-02-15T09:00:00Z:
POST https://yourapp.com/reminder
{
"userId": "usr_456"
}Features
Flexible scheduling for any use case.
One-time schedules
Run a task once at a specific time. Perfect for reminders and delayed actions.
Recurring schedules
Daily, weekly, or custom intervals. Set it and forget it.
Webhook delivery
We call your endpoint with the payload at the scheduled time.
Timezone support
Schedule in any timezone. We handle DST transitions correctly.
One-time vs Recurring
Scheduler uses at or interval; Cron uses expression-based schedules.
One-time
Run once at a specific time. Use the at field with an ISO 8601 timestamp.
Recurring
Repeat on an interval. We call your webhook at each interval until cancelled.
Limits & Quotas
Generous defaults for most workloads.
| Resource | Limit |
|---|---|
| Schedule precision | 1 second |
| Maximum schedules | 10,000 per account |
| Payload size | 1 MB |
| Schedule ahead | Up to 1 year |
| Webhook timeout | 30 seconds |
Use Cases
Common patterns for the Scheduler API.
Reminders & notifications
Send emails, push notifications, or SMS at a future time. Schedule when the user signs up.
Delayed jobs
Process something after a delay. Cancel subscriptions after trial, send follow-ups after purchase.
Recurring tasks
Weekly reports, daily syncs, monthly cleanup. Set the interval and we handle the rest.
Ready to schedule your first task?
Get your API key and start scheduling in minutes.