Skip to main content
SmartlyQ publishes to and manages every platform below through a single API. One POST /v1/social/posts call fans a post out to any combination of them — you reference connected accounts by account_ids and list the target platforms.

​
At a glance

supported  ·  not available through the API.
¹ Pinterest comments support fetch + reply, but not hide or delete.
² Google Business per-post analytics were deprecated by Google; location-level metrics aren’t exposed here.
³ Telegram is a credential connect, not OAuth: POST /v1/social/connect/telegram with bot_token + chat in the body connects immediately (no authorize URL) - or do it once from the dashboard’s Social Accounts page.
  • Headless connect lets you connect a new account from your own UI via POST /v1/social/connect/{platform} — supported on every platform above - 14 via OAuth connect_url (Discord included: its server-webhook authorize flow works headlessly), and Telegram via credential connect (bot_token + chat in the body, connects immediately). Poll GET /v1/social/connect/{state_token} to learn when the user finished. You can still connect from the Developer Dashboard. See Connecting accounts.
  • Direct messages are actively synced for Facebook, Instagram, and X. Meta platforms enforce a 24-hour reply window — you can only message a user within 24 hours of their last message.

​
Platform details

Every platform has its own page in the sidebar — pick one for its caption limit, post types, capabilities, connect method, and token notes.

​
Media

Attach media to a post with media_urls (publicly reachable HTTPS URLs), or upload to SmartlyQ storage first via POST /v1/media/upload-url. Formats — images jpg · jpeg · png · gif · webp; video mp4 · mov · m4v · webm.

​
Per-platform media rules

Each platform enforces its own limits on how many items you can attach, whether images and video can be mixed, and file size / duration. SmartlyQ validates these before publishing where it can, so you get an actionable error up front instead of a downstream failure.
¹ TikTok photo carousels accept up to 35 images and must be JPEG or WebP (PNG/GIF are rejected). A single video post is unaffected.
  • Instagram requires media — a text-only post will be rejected.
  • Stories / Reels / Shorts and carousels are detected automatically from the media you attach (see each platform above).
  • Aspect ratio is advisory: media well outside a platform’s supported range (e.g. a banner on an Instagram feed post) returns a non-blocking warnings entry on the create response rather than failing the post.

​
Keeping accounts healthy

Token lifetimes vary widely — SmartlyQ refreshes them for you. Check any account’s status with GET /v1/social/accounts/{id}/health, and if one turns unhealthy, send the user through its reconnect URL.