schedule_post
Put a draft on a time. Without your switch on the key, a person confirms with one click.
- Returns
- needs_confirmation with a review link, or scheduled when the key may.
- Does
- Schedules, after a click · scope
schedule - Who
- Free on every account
- Limits
- 2,000 planner calls a day per account, 200 of them writes.
- REST
POST /api/v1/posts/{id}/schedule
Try it on your account
This one puts a post on a time, so a person decides: your agent proposes it, the answer carries a review link, you confirm there with one click. That is why it does not run from this page.
Give it to your agent
Prompt for
No key in it: your agent reads it from SOCIALSCOUT_KEY or asks you.
Read the prompt
Set up SocialScout for me and use it: Belgian social-media data (viral brand videos, Flemish creators, Meta ads and what they say, the Belgian marketing calendar, my own numbers and my content calendar), as an MCP server.
## 1. Connect
You are Claude Code. Add SocialScout as an MCP server for my user (not in this project's .mcp.json, so the key never lands in git):
claude mcp add --transport http --scope user socialscout https://socialscout.be/api/mcp --header "Authorization: Bearer $SOCIALSCOUT_KEY"
First check that SOCIALSCOUT_KEY is set (echo ${SOCIALSCOUT_KEY:+set}); the shell fills it in when the command runs.
Then tell me to run /mcp (or restart Claude Code) so the socialscout tools load.
My key: use the environment variable SOCIALSCOUT_KEY. If it is not set, ask me for my key (I find it at https://socialscout.be/me/crew, under "SocialScout inside your AI": the part after ?key=). Treat it as a password: never print it back, never put it in a file that goes into git.
What the key may do: it reads everything my plan includes and may make drafts in my calendar (scopes read + drafts). It cannot schedule, publish or touch ads: schedule_post, reschedule_post, unschedule_post and delete_post answer "needs_confirmation" with a review_url. Give me that link; nothing happens until I confirm there.
Check the connection: call corpus_stats (works without a key), then list_accounts (needs the key), and tell me in one line what you see.
## The tool: schedule_post
Put a draft on a time. Without your switch on the key, a person confirms with one click.
Returns: needs_confirmation with a review link, or scheduled when the key may.
Does: Schedules, after a click · Free on every account
Limits: 2,000 planner calls a day per account, 200 of them writes.
Parameters:
- post_id (integer)
- when? (string): ISO 8601 time. Without an offset it is read as Belgian time ("2026-12-04T18:30"). Or "best_time" / "next_free_time".
- day? (string): YYYY-MM-DD (Belgian day)
- expect? (string): the post's `version` as last read: scheduling fails with `changed` when the post was edited since
With my key this answers needs_confirmation and a review_url: give me the link, I confirm with one click.
## Worked example
"Schedule my Friday draft."
Call schedule_post and answer from what it returns, with the links.
## Rules
- Every claim about a video, creator, brand or ad comes from a tool result. Say so when a tool returned nothing.
- Every result carries a link to its page on socialscout.be: put it next to each name.
- "5x" or "viral" means five times the account's own normal views, not a fixed number.
- Times without an offset are Belgian time (Europe/Brussels).
- A tool that answers with a sentence instead of data is telling you what it needs (a plan, a key): pass that on, do not guess.What your agent reads
Free with any SocialScout account. Commit a draft to a time: SocialScout publishes it then. Needs the schedule scope, which is off for a key until the account owner switches it on; without it this answers status "needs_confirmation" and a person confirms at review_url. `when` left out uses the draft's proposed time. A past time is an error, and there is no way to post at once.
| Parameter | Type | About |
|---|---|---|
post_id | integer | Required. |
when | string | ISO 8601 time. Without an offset it is read as Belgian time ("2026-12-04T18:30"). Or "best_time" / "next_free_time". |
day | string | YYYY-MM-DD (Belgian day) |
expect | string | the post's `version` as last read: scheduling fails with `changed` when the post was edited since |
More in planner
list_momentsThe Belgian marketing calendar: holidays, school breaks, sales, local events, with the day to start planning.list_accountsThe social accounts you connected, with what each can post.get_platform_rulesText and media limits per platform, as scheduling checks them.get_momentOne calendar moment in full: its dates, why it matters and how brands used it.list_calendarYour calendar between two days: drafts, scheduled and published posts.get_postOne post on your calendar, with what would stop it from going out.list_posting_timesThe posting times set for one connected account.suggest_timesFree times to post, with the reason for each.