How the social media API works
Everything goes through one endpoint, https://saymany.com/mcp, using the Model Context Protocol (JSON-RPC over HTTP). There is no separate REST API: the tools your AI app uses are the same ones your scripts call, so they stay in step.
Sign in with an API key
Create a key in the dashboard under Settings, API keys, or ask Saymany in a chat to "create an API key for my script". The key is shown once. Send it as Authorization: Bearer sm_live_…. A key acts for one workspace with your role, and you can revoke it at any time.
Schedule a post
Call a tool with tools/call. Publishing and scheduling need confirm: true; leave it out and you get a preview back instead.
POST https://saymany.com/mcp
Authorization: Bearer sm_live_…
Content-Type: application/json
Accept: application/json, text/event-stream
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "create_post",
"arguments": {
"text": "We are open late on Friday.",
"platforms": [
"x",
"bluesky"
],
"scheduled_at": "2026-12-05T18:00",
"confirm": true
}
}
}
What you can call
- Accounts: list_accounts, check_account, connect_account (sends a sign-in link)
- Media: media_upload_inline, media_import_url, media_create_upload for large videos
- Posts: preview_post, validate_post, create_post, update_post, reschedule_post, cancel_post, retry_post, get_post, list_posts
- Rules: get_platform_rules returns each network's limits
- Workspace: brands, members, usage and billing
Send tools/list to get every tool with its full input schema.
Networks
Live today: X, Bluesky, Telegram, Discord. Rolling out while each network finishes reviewing our app: Instagram, Facebook, Threads, LinkedIn, TikTok, YouTube, Pinterest, Google Business Profile. Posts to X are billed at X's own per-post price, passed on at cost.
Retries without double posts
Pass an idempotency_key with create_post. The same key returns the same post instead of publishing twice.
When another tool fits better
If you need a plain REST API with webhooks for every post event, or white-label sign-in for your own customers' accounts, a dedicated social media API provider may suit you better. Saymany is built for teams posting to their own accounts from AI apps and scripts.