create_draft
Make a draft post on your calendar. It never goes out by itself.
- Returns
- The draft with its proposed time and a review link where a person schedules it.
- Does
- Drafts · scope
drafts - Who
- Free on every account
- Limits
- 2,000 planner calls a day per account, 200 of them writes.
- REST
POST /api/v1/posts
Try it on your account
This makes a real draft on your calendar. It never goes out by itself; delete it there if you do not want it.
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: create_draft
Make a draft post on your calendar. It never goes out by itself.
Returns: The draft with its proposed time and a review link where a person schedules it.
Does: Drafts · Free on every account
Limits: 2,000 planner calls a day per account, 200 of them writes.
Parameters:
- account_ids? (integer[]): Connected accounts it goes to, from list_accounts. May be empty only for an idea.
- text? (string): The post's text, as it should go out.
- per_account? (object): An account's own text where it should differ: {account_id: text}.
- media_ids? (string[]): Files from request_upload_link or import_media, in order.
- link? (string | null)
- first_comment? (string | null)
- options? (object): Per account platform options: {account_id: {igKind: "reel" | "feed" | "story"}}.
- proposed_time? (string): Where the draft sits on the calendar. ISO 8601 (Belgian time without an offset), "best_time" or "next_free_time". Leave out for a draft without a time. A draft never goes out by itself.
- day? (string): With proposed_time left out or "best_time": the best hour on this day.
- time_reason? (string): One plain sentence on why this time, shown to the person on the card.
- moment? (string | null): Calendar moment slug it is for, from list_moments.
- title? (string | null): A working title for the calendar (not published).
- idea? (boolean): true = a placeholder on a day, content to come.
- idempotency_key (string): Any unique string for this create (a UUID). Sending the same key again returns the first result instead of making a second post.
Use it well: Always send an idempotency_key; give the person the review_url.
A draft never goes out by itself. Send a fresh idempotency_key with every create, and give me the review_url from the answer.
## Worked example
"Write a draft for Sinterklaas on our LinkedIn, Friday evening."
Call create_draft {"account_ids":[],"text":"Speculaas is back. Fresh from the oven every morning from 7.","idea":true,"title":"Speculaas is back","moment":"sinterklaas"} 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. Make a draft post. It appears on the calendar at its proposed time and waits there: a draft never goes out by itself, and a person schedules it with one click. Without a time it is a draft without a date. A past time is an error.
| Parameter | Type | About |
|---|---|---|
account_ids | integer[] | Connected accounts it goes to, from list_accounts. May be empty only for an idea. |
text | string | The post's text, as it should go out. |
per_account | object | An account's own text where it should differ: {account_id: text}. |
media_ids | string[] | Files from request_upload_link or import_media, in order. |
link | string | null | |
first_comment | string | null | |
options | object | Per account platform options: {account_id: {igKind: "reel" | "feed" | "story"}}. |
proposed_time | string | Where the draft sits on the calendar. ISO 8601 (Belgian time without an offset), "best_time" or "next_free_time". Leave out for a draft without a time. A draft never goes out by itself. |
day | string | With proposed_time left out or "best_time": the best hour on this day. |
time_reason | string | One plain sentence on why this time, shown to the person on the card. |
moment | string | null | Calendar moment slug it is for, from list_moments. |
title | string | null | A working title for the calendar (not published). |
idea | boolean | true = a placeholder on a day, content to come. |
idempotency_key | string | Required. Any unique string for this create (a UUID). Sending the same key again returns the first result instead of making a second post. |
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.