Skip to main content

Schedules

In addition to sending a message once, you can create a schedule, and we will publish the message in the given period. To create a schedule, you simply need to add the Upstash-Cron header to your publish request.

Schedules can be configured using cron expressions. crontab.guru is a great tool for understanding and creating cron expressions.

We use UTC as timezone when evaluating cron expressions.

The following request would create a schedule that will automatically publish the message every minute:

curl -XPOST \
-H 'Authorization: Bearer XXX' \
-H "Content-type: application/json" \
-H "Upstash-Cron: * * * * *" \
-d '{ "hello": "world" }' \
'https://qstash.upstash.io/v1/publish/https://example.com'

All of the other config options can still be used.

info

It can take up to 60 seconds for the schedule to be loaded on an active node and triggered for the first time.

You can see and manage your schedules in the Upstash Console.