List Scheduled Posts
postnitro_list_scheduled_postsRead-onlyIdempotent
List scheduled posts and drafts whose scheduled time falls within a date range. Returns each post with its captions, selected social accounts, and attached design details.
Optionally narrow the results to specific social accounts with socialAccountIds — useful for "what's scheduled on my LinkedIn next week". The filter applies to POSTS, not to the accounts within them: a post targeting both LinkedIn and Instagram is returned when you filter by either, and its accounts array still lists every account it targets.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"fromDate": "<fromDate>",
"toDate": "<toDate>"
},
"name": "postnitro_list_scheduled_posts"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| toDate | Yes | End of range (ISO-8601 recommended). Matches scheduledAt <= toDate. | |
| fromDate | Yes | Start of range (ISO-8601 recommended). Matches scheduledAt >= fromDate. | |
| socialAccountIds | No | Optional social-account IDs (from postnitro_list_social_accounts) to filter by. Returns only posts targeting at least ONE of them. Omit for every post in the range. Unknown IDs are not an error — they simply match nothing, so a filter of only unknown IDs returns an empty list. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| count | Yes | Number of posts in the range | |
| posts | Yes |