Posts

Create a post

Creates a draft, or a scheduled post when scheduled_at is set (ISO-8601 with offset; a bare local time is read in the account timezone). Upload media afterwards with POST /posts/{id}/media, then publish or schedule. Rules: TikTok-only posts cannot be a carousel or story and carry no first comment or comment auto-reply; scheduling needs a caption (stories excepted) and a future time; the plan's monthly cap counts scheduled and published posts, a plain draft never holds a slot; a comment auto-reply on a scheduled post needs a free live comment-trigger slot (403 plan_limit_reached). tiktok.privacy_level must be one of the creator's options from GET /posts/capabilities. Requires the write scope.

post/posts

Request

  • Base URL: https://sumgenius.ai/api/v1
  • URL: https://sumgenius.ai/api/v1/posts
  • Auth: one of:
    • API key in header X-SumGenius-Api-Key
    • HTTP bearer

Request body

platform'instagram' | 'facebook' | 'both' | 'tiktok' | 'instagram_tiktok' | 'facebook_tiktok' | 'all'

A target set. both = Instagram + Facebook; all = all three.

post_type'feed_post' | 'carousel' | 'reels' | 'story'
captionstring
hashtagsstring[]

Without the #.

scheduled_atstring date-time nullable

ISO-8601. Null on PATCH turns a scheduled post back into a draft.

first_commentstring nullable

Posted under the post right after publish. Instagram and Facebook only.

collaboratorsstring[]

Instagram usernames to invite as collaborators. Instagram only.

cover_offset_msinteger nullable

Reels: which frame is the cover.

Response

201 created

Changes

No recorded changes to this operation across all 1 revision of this API.