# Schedulin for Grok Bot: how to post to social media

> A brief for Grok Bot (or any AI agent) on scheduling and publishing social media posts through Schedulin (https://www.schedulin.app), a social media scheduler with a hosted MCP server. Human guide: https://www.schedulin.app/grok-bot

## 0. Are you connected?

Try `list_social_accounts`. If you don't have that tool, you aren't connected yet. Tell the user to paste this into the chat, approve adding the connector, and approve the Schedulin sign-in that opens in the browser:

```
Connect to the Schedulin social media scheduler MCP server at https://mcp.schedulin.app/mcp
```

- MCP server: `https://mcp.schedulin.app/mcp` (streamable HTTP, OAuth 2.1 with dynamic client registration).
- If the browser sign-in can't complete, the user can create an API key at https://dashboard.schedulin.app/settings/api-keys and store it as a Bot secret. Send it as `Authorization: Bearer <key>`.
- The user needs a Schedulin account (https://auth.schedulin.app/register, 7-day free trial) with at least one social account connected in the dashboard. You can't connect social accounts for them, and you never receive their platform passwords.

## 1. Rules of engagement

- Call `list_social_accounts` first and use the returned `id` as `socialAccountId`. Never guess an ID.
- If the user has more than one account on a platform and didn't say which, ask.
- Don't publish immediately unless the user says "now". Prefer a `scheduledAt` time (ISO 8601 with a time zone offset), `action: "queue"` for the next queue slot, or `action: "draft"` when they want to review first.
- One post targets one account. To cross-post, create one post per account and adapt the caption to each platform's limit.
- Post the user's text as written unless they ask you to write or edit it.
- When you're done, report each post's ID, account, and scheduled time.
- After a post's time passes, check it with `get_post` and tell the user if it failed and why.
- In routines, save drafts unless the user has said the Bot may publish without review.

## 2. Server instructions

Schedulin schedules and publishes social media posts across TikTok, Instagram, YouTube, X (Twitter), LinkedIn, Facebook, Pinterest, Threads, Bluesky, Reddit, and Telegram.

To create a post:
1. Call list_social_accounts to get the socialAccountId — never guess an ID.
2. If unsure about a platform, call get_platform_requirements: caption limits, media rules, and whether platformConfiguration is required (with its JSON Schema). For TikTok also call get_tiktok_creator_info; for Pinterest, get_pinterest_boards.
3. Attach media in media[].url. You never receive file bytes yourself:
   - Public image/video URL: pass it straight in; the server downloads it.
   - File on the user's device or pasted into chat: call create_media_upload_link, give the user the url, wait for them to confirm, then use the url from list_media (newest first). Never claim you uploaded a file.
   - AI image: generate_image, then poll get_ai_generation until COMPLETED.
   - AI UGC video (actor talking to camera): create_ugc_video, then get_ugc_video, then add_ugc_video_to_media.
   - NEVER invent or hand-build a media URL (e.g. an r2.schedulin.app/... key). Use only URLs a tool returned or real public sources.
4. Call create_post with scheduledAt for a set time, action:"queue" for the next queue slot (get_next_queue_slots previews them), or action:"draft" (no scheduledAt).

Carousels: media[] order IS the slide order; there is no position field. To reorder a post, call get_post, then update_post with media set to EVERY item as {"id": <media[].id>} in the new order. Leaving one out removes it.

Errors come back as text with an HTTP status — read the message, it usually says what to fix.

## 3. Platform rules

Call `get_platform_requirements` for the live rules and the JSON Schema of `platformConfiguration` before using settings you're unsure of. Summary:

- **X (Twitter)**: Standard accounts get 280 characters per tweet; links count as 23. A tweet carries up to 4 images or 1 video, not both. Videos run up to 140 seconds on standard accounts. Community posts need you to be a member of that community. Polls can't include media. Settings: `reply_settings` (everyone · following · mentioned), `community_id` (Community URL or numeric ID), `poll` (options (2–4), duration_minutes (1–10080)), `quote_tweet_id` (Tweet ID), `in_reply_to_tweet_id` (Tweet ID).
- **Instagram**: Every Instagram post needs at least one image or video. Captions max out at 2,200 characters; only the first 125 show before “more”. Only Business and Creator (professional) accounts can be posted to. Story videos are limited to 60 seconds. Settings: `placement` (feed · reels · stories), `first_comment` (Text, up to 2,200 characters), `collaborators` (Instagram usernames), `share_to_story` (true · false), `trial_reel_type` (manual · auto).
- **TikTok**: Every TikTok post needs a video or photos. Captions can be up to 2,200 characters for video and 4,000 for photo posts. Privacy and interaction options come from your account's creator info; the Bot checks them with get_tiktok_creator_info first. TikTok may cap how many posts an account can publish per day. Settings: `privacy_status` (public · friends · follower_of_creator · self_only), `allow_comment / allow_duet / allow_stitch` (true · false), `disclose_branded_content / disclose_your_brand` (true · false), `is_ai_generated` (true · false), `title` (Up to 90 characters).
- **YouTube**: Every YouTube post needs exactly one video. Titles are limited to 100 characters and descriptions to 5,000. Shorts are vertical videos up to 3 minutes long. A category and the made-for-kids setting are required. Settings: `title` (Up to 100 characters), `visibility` (public · unlisted · private), `categoryId` (YouTube category ID), `madeForKids` (true · false), `tags` (List of strings), `containsSyntheticMedia` (true · false).
- **LinkedIn**: Posts are limited to 3,000 characters; the feed cuts off around 210. Posting is from your personal profile. Company Pages aren't supported yet. Polls, articles, and media can't be combined in one post. Settings: `visibility` (PUBLIC · CONNECTIONS · LOGGED_IN), `first_comment` (Up to 1,250 characters), `poll` (question, options (2–4), duration), `article` (source URL, title, description), `reshare_disabled` (true · false).
- **Facebook**: Posting is to Facebook Pages, not personal profiles or groups. Posts over 477 characters are truncated in the feed. Reels need vertical video. Settings: `placement` (feed · reels · stories), `first_comment` (Up to 8,000 characters), `title` (Text), `share_to_story` (true · false).
- **Threads**: Each Threads post is limited to 500 characters. Up to 10 images or videos per post. One topic tag per post. Settings: `reply_control` (everyone · accounts_you_follow · followers_only · mentioned_only), `topic_tag` (Text), `poll` (options (2–4), question), `quote_post_id` (Threads post ID), `link_attachment` (URL).
- **Pinterest**: Every Pin needs one image or video and a board. Titles max out at 100 characters and descriptions at 800. Settings: `board_ids` (Board ID), `board_section_id` (Section ID), `title` (Up to 100 characters), `link` (URL), `alt_text` (Up to 500 characters).
- **Bluesky**: Posts are limited to 300 characters. Up to 4 images per post. Settings: `alt_text` (One entry per image), `langs` (Up to 3 language codes), `quote_post_uri` (at:// URI), `labels` (!warn, nudity, graphic-media, …).
- **Reddit**: Every Reddit post needs a subreddit and a title. Each subreddit has its own rules on flair, links, and media. New accounts may be blocked by subreddit karma or age limits. Settings: `subreddit` (Name, with or without r/), `title` (Up to 300 characters), `flair_id / flair_text` (Flair ID or text), `link_url` (URL), `nsfw / spoiler` (true · false).
- **Google Business Profile**: Posts are limited to 1,500 characters and one photo. Event and offer titles are limited to 58 characters. Settings: `topic_type` (STANDARD · EVENT · OFFER), `call_to_action` (LEARN_MORE · BOOK · ORDER · SHOP · SIGN_UP · CALL), `event` (title, start_date, end_date).
- **Telegram**: Up to 10 media items per message. The Schedulin bot must be an admin in the channel or group. Settings: `disable_notification` (true · false), `disable_link_preview` (true · false).
- **Discord**: The Schedulin bot must be in the server with permission to post in the channel. Up to 10 attachments per message. Settings: `channel` (Numeric channel ID).

## 4. Tools (35)

- `list_posts`: List posts filtered by status, social accounts, or tags, with pagination
- `get_post`: Retrieve a single post by its ID with all relations
- `create_post`: Create a draft, scheduled, queued, or immediately published post; external media URLs are imported into publicly accessible media storage
- `update_post`: Update a draft or scheduled post by ID.
- `delete_post`: Delete a post by its ID
- `list_social_accounts`: Retrieve all connected social media accounts for the authenticated user
- `list_tags`: Retrieve all tags for the authenticated user
- `list_ideas`: List the workspace's Ideas board: its columns in order (the last column is Done) and every idea on it.
- `create_idea`: Save a content idea to the workspace's Ideas board, at the bottom of a column (the first column when columnId is omitted).
- `update_idea`: Edit an idea's title or description, or move it to the bottom of another column.
- `create_tag`: Create a new tag (max 5 per user)
- `update_tag`: Update an existing tag's name or color
- `delete_tag`: Delete a tag by its ID
- `publish_post`: Publish a draft post to its connected social account, immediately or at a scheduled time
- `update_post_tags`: Replace all tags on a post with the provided tag IDs
- `get_post_analytics_summary`: Retrieve the latest analytics snapshot for a post (impressions, likes, comments, shares, etc.)
- `get_analytics_overview`: Workspace-wide analytics totals for a date window (impressions, reach, likes, comments, shares, saves, video views, clicks, engagement, follower audience, posts published) with percent change vs the previous window of the same length.
- `get_analytics_by_platform`: Workspace analytics totals for a date window grouped by platform, highest engagement first
- `get_top_posts`: The workspace's best-performing posts in a date window, ranked by a metric (default engagementTotal)
- `get_post_analytics_series`: Retrieve time-series analytics metrics for a post
- `list_media`: List media library items with pagination, text search, type and tag filters
- `get_media`: Retrieve a media library item by its ID
- `create_media_from_url`: Import a publicly reachable image or video into the media library by URL — the server downloads it into a public media bucket.
- `create_media_upload_link`: Create a short-lived URL to a page where the user uploads files from their device (or a file they pasted into this chat) directly into the media library.
- `get_platform_requirements`: List per-platform posting requirements: caption length limits, media count/type rules, whether `platformConfiguration` is required, its JSON Schema when server-validated, and helper endpoints for dynamic values.
- `get_next_queue_slots`: Get the next available queue slot times (UTC) for a social account, based on its queue schedule, capacity, and timezone.
- `get_queue_schedule`: Get a social account's weekly queue schedule: each slot's weekday (0 = Sunday), wall-clock time (HH:MM) and capacity, in the account's timezone.
- `get_pinterest_boards`: List boards for a connected Pinterest account; may refresh credentials or mark an invalid connection disconnected.
- `get_tiktok_creator_info`: Fetch privacy-level options, duration limits, and interaction settings for a connected TikTok account; may refresh credentials and cache the result.
- `generate_image`: Send a text prompt to the configured AI image provider and start a generation job.
- `get_ai_generation`: Get the status and result of an AI image generation job: status (PENDING/PROCESSING/COMPLETED/FAILED/CANCELLED), result URL when completed, and metadata
- `create_ugc_video`: Create an AI UGC video: a realistic actor talking to camera, selfie-style, pitching a product.
- `get_ugc_video`: Get an AI UGC video's status (SCRIPTING → GENERATING_ACTOR → GENERATING_VOICE → SYNTHESIZING_VIDEO → GENERATING_BROLL → COMPOSING → COMPLETED, or FAILED with errorMessage).
- `add_ugc_video_to_media`: Save a COMPLETED AI UGC video to the media library and return its permanent `url` — pass that as media[].url in create_post.
- `list_ugc_avatars`: List the saved, reusable AI UGC avatars (actors) for this workspace.

## 5. Things the user may ask

- "Post this now" → `create_post` with `action: "now"`.
- "Schedule for Friday 9am" → `create_post` with `scheduledAt`.
- "Add it to my queue" → `get_next_queue_slots` to preview, then `create_post` with `action: "queue"`.
- "Save as a draft" → `create_post` with `action: "draft"`.
- "Here's a photo from my phone" → `create_media_upload_link`, wait for the user, then `list_media`.
- "Make an image for it" → `generate_image`, poll `get_ai_generation`.
- "Move Thursday's post to Friday" → `list_posts`, then `update_post`.
- "What's scheduled this week?" → `list_posts`.
- "How did last week go?" → `get_analytics_overview`, `get_top_posts`.

## More

- Human guide: https://www.schedulin.app/grok-bot
- Per-platform guides: https://www.schedulin.app/grok-bot/x, https://www.schedulin.app/grok-bot/instagram, https://www.schedulin.app/grok-bot/tiktok, https://www.schedulin.app/grok-bot/youtube, https://www.schedulin.app/grok-bot/linkedin, https://www.schedulin.app/grok-bot/facebook, https://www.schedulin.app/grok-bot/threads, https://www.schedulin.app/grok-bot/pinterest, https://www.schedulin.app/grok-bot/bluesky, https://www.schedulin.app/grok-bot/reddit, https://www.schedulin.app/grok-bot/google-business-profile, https://www.schedulin.app/grok-bot/telegram, https://www.schedulin.app/grok-bot/discord
- MCP guide: https://www.schedulin.app/mcp
- Agent authentication: https://www.schedulin.app/auth.md
- API reference: https://developers.schedulin.app/reference
