Social Media Posting — User Guide | YoBench

What the Social Media module does

The module is a single editor and scheduler for posting to 18 platforms. You write the content in a TipTap editor, attach media, pick targets, set a time — and the post fires immediately or on schedule. OAuth providers with auto-refresh and platforms with direct API tokens/secrets are both supported.

What you get:

• One post → many platforms — a single draft is published to the chosen networks at once.
• Rich editor — TipTap; the content is stored in three formats simultaneously (content_json, content_html, content_text).
• Scheduling — scheduled_at (ISO 8601) or instant send.
• Media — drag-and-drop files into the editor with previews; per-adapter limits.
• Platform-specific fields — YouTube title, Reddit NSFW, Telegram parse_mode and so on.
• OAuth with auto-refresh — tokens are refreshed automatically with a 1-minute pre-expiry buffer.
• Local OAuth server on port 19284 for interactive sign-in.

Supported platforms (18)

All have working adapters: Discord, Telegram, VK, OK, Twitter (X), Facebook, Instagram, Threads, TikTok, YouTube, WhatsApp, Reddit, LinkedIn, Substack, Boosty, Patreon, WeChat, Weibo.

Auth modes:

• OAuth (auto-refresh) — Reddit, Instagram, Facebook, LinkedIn, Threads, Patreon, YouTube, TikTok.
• API tokens + extras:
  • Telegram — bot_token + chat_id.
  • Discord — webhook_url.
  • VK — access_token + group_id.
  • OK — app_id, app_public_key, app_secret, access_token, session_key, group_id.
  • Weibo — access_token + uid.
  • WeChat — app_id, app_secret, token, aes_key.
  • Twitter — OAuth 1.0a: api_key, api_secret, access_token, access_token_secret.
  • WhatsApp — template_id, recipient_phone.

Post parameters

• Content — content_json (TipTap structure), content_html, content_text.
• Media — array of files with mime_type, size, local path.
• Target platforms — list of accounts to publish to.
• Schedule — scheduled_at. Empty means send immediately.
• Status — draft / scheduled / sending / sent / partial / failed / cancelled.
• Platform-specific fields — extra_fields (JSON), set per account.

Platform-specific fields

Global settings

There are no dedicated posting* keys in the central settings. Everything lives in the database (posting_platforms, posting_posts, posting_post_platforms, posting_media).

Workflow

1. Connect platforms

1. Open the Posting module from the left sidebar.
2. On the Platforms tab add an account.
3. Fill in tokens or run the OAuth flow (a browser opens at localhost:19284).
4. The Test connection button validates access.

2. Create a post

1. On the Posts tab click New post.
2. Write content in the TipTap editor, attach media.
3. Pick the target platforms (multiple at once is fine).
4. Fill in platform-specific fields (e.g. subreddit for Reddit).

3. Send

• Send now — the post fires immediately.
• Schedule — set scheduled_at; the scheduler will publish automatically.
• Cancel — drafts and scheduled posts can be cancelled before they go out; the post is marked cancelled and isn't sent.

4. Track status

The post list shows statuses. partial means the post landed on some platforms but not others. Open the details to see the per-platform error and retry that single platform without re-sending to the ones that already succeeded.

Next steps

• Pull content sources from RSS and RAG contexts, and brainstorm posts in AI Chat.
• Use Docs to draft longer pieces before publishing.

Help and feedback

Want Mastodon, Bluesky, Pinterest, or A/B post testing? Contact us via the feedback form.