Platform Guide

Threads

Threads works well for short conversational copy and thread-like multi-post flows. UniPost treats it like a text-first platform with optional media and native thread behavior.

Overview

Threads supports text-only posts, single-image or single-video posts, and larger carousel-style containers. Use `thread_position` for multi-post sequencing. Do not use `first_comment` here.

Supported capabilities

Capability	Supported	Notes
Text posts	✓	Up to 500 characters
Image posts	✓	Single image or carousel
Video posts	✓	Single video or carousel
Carousel	✓	2-20 items, mixed media allowed
Threads	✓	Use `thread_position`
First comment	X	Use threads instead

Requirements

Field	Required	Limits	Notes
caption	Optional	500 chars	Short-form conversational copy
media_urls	Optional	single asset or 2-20 carousel	Mixed media allowed only in carousel flow
thread_position	Optional	1-indexed	Preferred over first_comment
first_comment	Rejected	n/a	Validate will catch this before publish

Example requests

The examples below are intentionally small and copyable. They show the request body only, assuming a standard POST /v1/social-posts call with Bearer auth.

Text-only post

{
  "caption": "Just shipped a new release ✨",
  "account_ids": ["sa_threads_1"]
}

Carousel

{
  "caption": "Conference highlights",
  "account_ids": ["sa_threads_1"],
  "media_urls": [
    "https://cdn.example.com/talk-1.jpg",
    "https://cdn.example.com/talk-2.jpg",
    "https://cdn.example.com/keynote.mp4"
  ]
}

Thread

{
  "platform_posts": [
    { "account_id": "sa_threads_1", "caption": "1/ A cleaner docs IA matters", "thread_position": 1 },
    { "account_id": "sa_threads_1", "caption": "2/ Less searching, more building", "thread_position": 2 }
  ]
}

Common validation errors

Code	What it means
caption_too_long	Caption exceeds 500 characters
first_comment_unsupported	Threads should use thread_position instead
too_many_media	More than 20 carousel items supplied

Once you know the correct request shape for this platform, move to the API reference for the full endpoint contract, response schema, and validation payload shape.