Next Scheduled Dates
The nextScheduleDates query returns the next available slot from each social account's Account Schedule — the time Postpone would use if you scheduled a new post to that account right now. This is the same suggestion the app uses to pre-fill the date and time on the Schedule Post page, so it's useful for automations that want to place a post at the account's next open slot.
It is not a lookup of when your already-scheduled posts go out — it looks forward for the next free slot, taking your existing scheduled posts into account.
schedulingMode: QUEUE_NEXT to the scheduling mutation instead. It picks and takes the slot in a single request. Use nextScheduleDates when you want to show the upcoming slot — to pre-fill a date picker, say — rather than post to it.What You Get Back
scheduleDate is the earliest upcoming slot in the account's schedule that isn't already taken by a scheduled post. A slot is considered taken when a scheduled post falls on it or within about 30 minutes of it, so the returned time is always clear of your existing posts.
scheduleDate is null only when the account has no usable schedule — no slots, or no timezone set. A schedule with slots always returns a date: the search runs as far ahead as your queue requires, so an account booked solid for months returns the first slot past the end of the queue rather than nothing.
Reddit accounts are not supported — including one in socialAccountIds makes the query fail with a CUSTOM_SCHEDULE_NOT_SUPPORTED error.
AccountScheduleDateType
null if the account has no usable schedule.nextScheduleDates Query
socialAccounts query to retrieve IDs for your connected accounts. See Social Accounts.query nextScheduleDates($socialAccountIds: [ID]) {
nextScheduleDates(socialAccountIds: $socialAccountIds) {
socialAccountId
scheduleDate
}
}
{
"socialAccountIds": ["789", "790"]
}
{
"data": {
"nextScheduleDates": [
{
"socialAccountId": "789",
"scheduleDate": "2025-01-16T09:00:00Z"
},
{
"socialAccountId": "790",
"scheduleDate": null
}
]
}
}
scheduleDate is null (account 790 above). To place a post at the returned slot, pass it as the scheduled time when creating the post — or skip the round trip and let the mutation do it with schedulingMode: QUEUE_NEXT.