Skip to main content
Publishing

Platform options

First comment, Instagram and Facebook Stories and Reels, Pinterest boards and Google Business Profile posts: what each option does and where it works.

Options per account

Options are set per connected account in the composer (cards under the media step) or in the API as platform_options keyed by account id. Run a preflight (POST /api/posts/validate) or call get_platform_requirements to see the questions an assistant should ask for each platform.

First comment

A text posted as a comment (or reply) right after the post is published, for example hashtags or a link. If the comment cannot be posted, the post still succeeds and the target shows a warning. A retry never posts the comment twice.

PlatformHow it is postedNeedsMax
InstagramComment on the new postComment permission (instagram_business_manage_comments, or instagram_manage_comments with Facebook Login)2,200 chars
FacebookComment on the Page post (not Stories)pages_manage_engagement, or a Page role that can moderate8,000 chars
LinkedInComment by the connected memberShare permission; UNVERIFIED whether more is required1,250 chars
ThreadsReply to the new postStandard publishing permissions500 chars
XReply to the (first) tweetStandard posting permission280 weighted
YouTubeTop-level comment on the video (50 quota units)youtube.force-ssl permission10,000 chars

Stories cannot have a first comment. The limits shown are this app's own checks; the platform may enforce others.

Instagram and Facebook post types

PlatformTypeMediaNotes
InstagramFeedOne JPEG or a carousel of 2 to 10 filesCaption up to 2,200 characters.
InstagramReelOne MP4, 3 s to 15 min, up to 300 MB, 9:16 recommendedShown in the Reels tab.
InstagramStoryOne JPEG (up to 8 MB) or one MP4 of 3 to 60 s (up to 100 MB), 9:16 recommendedNo caption is published and no first comment is possible. Disappears after 24 hours.
FacebookFeedText, link or up to 10 photosThe default; video in the normal feed is not supported.
FacebookReelOne MP4, 9:16, at least 540x960, 3 to 90 s, 24 to 60 fpsPost text becomes the description. Facebook allows 30 API-published Reels per 24 hours.
FacebookStoryOne photo (up to 10 MB) or one 9:16 MP4 up to 60 sNo text and no first comment. A photo or video already used in a post cannot be used for a Story.
  • Facebook fetches Reel and Story videos from a public Sociquza media URL, so the server must be publicly reachable.
  • Sociquza cannot measure video length. It reminds you of the limits, and the platform rejects videos outside them.
  • Choose Automatic on Instagram to keep the old behaviour: photos and carousels are feed posts and a single video is a Reel.

Pinterest

  • Board: pick one of your boards (loaded from Pinterest). Remember as default stores it for the account; without a choice the default (first board found when connecting) is used.
  • Title: up to 100 characters. When set, the whole post text becomes the description (up to 800 characters). When empty, the first line of the text is the title, as before.
  • Destination link: the page the Pin opens (http or https).
  • Alt text: up to 500 characters.

API: GET /api/accounts/ACCOUNT_ID/pinterest/boards and PUT /api/accounts/ACCOUNT_ID/pinterest/default-board with {"board_id": "..."}. Apps in Pinterest Trial access can only create Pins visible to their creator.

Google Business Profile

  • Connect with Google (scope business.manage). Every location you manage becomes one account in Sociquza.
  • Update: text, an optional button and an optional image.
  • Offer: title, start, end and optionally a coupon code, redeem link and terms (offers have no button).
  • Event: title, start and end, optional button.
  • Buttons: Book, Order, Shop, Learn more, Sign up (all need a link) and Call (no link).
  • Text up to 1,500 characters and one JPEG or PNG image; video is not offered. Event and offer dates are in the business's local time.

Callback URL to register at Google: the one shown in the keys dialog of the Google Business Profile platform.

API example

platform_options
{
  "INSTAGRAM_ACCOUNT_ID": { "post_type": "story" },
  "FACEBOOK_ACCOUNT_ID": { "post_type": "reel", "first_comment": "More on our site" },
  "PINTEREST_ACCOUNT_ID": { "board_id": "1234567890", "title": "Pasta night", "link": "https://example.com/pasta", "alt_text": "A bowl of pasta" },
  "GBP_ACCOUNT_ID": { "post_type": "offer", "title": "20% off", "start": "2026-11-01T09:00", "end": "2026-11-07T21:00", "coupon_code": "SAVE20" }
}

v0.1.2

Platform options | Documentation | Sociquza