Scheduling Posts

Viral Vibes allows you to schedule your content to go live at the perfect time, even when you are offline.

How it Works

Scheduling uses our robust background queue system (powered by Upstash QStash). When you submit a post with a future date, Viral Vibes saves the post to your database with a status of scheduled.

The system then enqueues a delayed HTTP request. Exactly at the time you specified, the queue wakes up our API, which downloads your media, rotates your expired tokens if necessary, and publishes the post across all selected platforms.

Scheduling via the Dashboard

1. Create a new post and select your platforms.
2. Locate the datetime picker next to the "Post Now" button.
3. Select a future date and time.
4. The button will change from "Post Now" to "Schedule Post".
5. Click it! You can view the scheduled post in the "Recent Posts" table.

Scheduling via the API

When using the headless API, simply include the scheduleDate parameter in your JSON payload. The date must be a valid ISO 8601 string.

{
  "post": "Good morning! ☀️",
  "platforms": ["x"],
  "scheduleDate": "2026-03-25T08:00:00.000Z"
}