Scheduling Posts
Next Scheduled Dates
Query the next scheduled post date for each connected social account.
The nextScheduleDates query returns the next date a post is scheduled to go out for each of the specified social accounts. This is useful for building dashboards or automation workflows that need to know when content is next due to publish.
AccountScheduleDateType
socialAccountId
ID
The ID of the social account.
scheduleDate
DateTime
The datetime of the next scheduled post for this account.
nextScheduleDates Query
socialAccountIds
[ID]
List of social account IDs to query. Use the
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": "2025-01-16T12:00:00Z"
}
]
}
}
Accounts with no future scheduled posts will not appear in the results. Only accounts that have at least one upcoming scheduled post will be included.