ERROR state.
Setting a Schedule
When composing a post, you can assign a publish time in two ways:1
Use the date/time picker
In the post composer, click the date/time field and select a date and time from the calendar picker. PostSider places the post in the queue for the selected time.
2
Schedule via the API
Pass a
date field in ISO 8601 format when creating a post through the public API or SDK. Example: "date": "2026-07-01T09:00:00Z".Immediate vs. Scheduled Publishing
You have two options when creating a post:The Visual Calendar
The Calendar page gives you a full view of everything in your publishing queue. Each scheduled post appears as a block on its scheduled date and time.- Scan your week or month at a glance to spot gaps or over-crowded days
- Click any post to open it and make edits inline
Editing a Scheduled Post
You can edit eligible draft and queued posts before publication. Published posts cannot be edited or rescheduled, and pending-approval posts must be approved or rejected rather than dragged into the queue. Changes to an eligible post update its scheduled job.Rescheduling a Post
To move a post to a different time, open the post and update the date/time field, then save. PostSider reschedules the publish job to the new time instantly.What Happens When Publishing Fails
If PostSider cannot publish a post - because of a network error, an expired token, or a platform-side issue - the post is marked as Error and an error message is attached to it explaining what went wrong. PostSider surfaces the failure clearly so you can diagnose it and act on it. When you see a failed post:- Read the error message to understand the cause
- Fix the underlying issue (e.g., reconnect the channel, shorten the content)
- Use the Retry action on the post to reschedule it
Rate Limits
Every social platform enforces its own API rate limits. PostSider uses durable Temporal workflows and provider-specific retry/backoff behavior, but it does not guarantee one universal spacing policy across every provider.If a provider throttles a request, inspect the resulting error and retry according to that provider’s response. Publication failure does not imply that every other target channel failed.
Queue plans
The queue plan defines when each channel publishes, sofind-slot can pick the next free time automatically. Configure it under Settings → Queue Plan:
- Per-channel slots - set the times each channel can publish at (for example 09:00, 12:00, 18:00).
- Weekdays - choose which days of the week the slots apply to.
- Timezone - give a channel its own timezone. Resolution order: channel timezone, then the organization’s default timezone, then
UTC. - Team assignment - optionally assign a channel to a specific member.
GET /public/v1/find-slot/:id (and the composer’s queue picker) returns the next free slot for the current weekday, looking ahead up to 365 days.
Smart Slots
Smart Slots (“Suggest best time” in the composer) suggests a publish time by blending per-platform peak-hour heuristics with the channel’s own posting rhythm - the hours its published posts already use, once there are at least 8. It avoids times already occupied in the queue and suggests one time per local day.Smart Slots is based on posting rhythm and platform heuristics, not engagement predictions. PostSider does not persist a universal engagement history for every provider.

