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.
Short-form text, media, and native threaded conversations.
At a glance
Publishing
Supported
Scheduling
Supported
Analytics
Supported
Inbox
Limited
Connection
OAuth via Meta — Quickstart and White-label both supported
Feature matrix
Feature
Support
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
Scheduling
✓
Use scheduled_at
Inbox (replies)
✓
Routed as threads_reply
First comment
X
Use threads instead
Known constraints
Limitation
Why
Daily safety cap
250 publishes/day per connected Threads account (UTC reset). Failed posts do not count toward the cap.
No first-comment flow
Use thread_position for follow-up content
No DMs
Threads API does not expose direct messages today
Publishing
Ready to publish?Use the shared Publishing guide for hosted URLs, local file uploads, preflight validation, and async publish status. Then use the Threads examples below for platform-specific payload shape.
Publish examples by surface
Each example calls POST/v1/posts with Bearer auth. Swap the account_ids for your own, then copy the snippet for your language.
Text-only post
Carousel
Thread
Media & field requirements
Field
Required
Limits
Notes
caption
Optional
500 chars
Short-form conversational copy
media_urls or media_ids
Optional
single asset or 2-20 carousel
Use media_urls for hosted assets or media_ids for local files uploaded via POST/v1/media. 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
Hosted URLs: pass the public URL in media_urls. Local files: reserve an upload with POST/v1/media, PUT the bytes to the returned upload_url, then publish with media_ids. Full flow in the Publishing guide.
Media specifications
Per-surface limits for text, images, and video. These are the source of truth UniPost uses for preflight validation and media optimization — treat hard-limit values as enforced and "recommended" values as platform guidance.
1 standalone, or mixed into a carousel (≤ 20 children total)
Video
Max file size
1 GB
Video
Duration
Up to 5 min
Video
Aspect ratios
9:16, 1:1, 16:9 all accepted
Video
Resolution
1,080p recommended
Video
Frame rate
30 fps recommended
Video
Codec
H.264 + AAC-LC (128 kbps)
Analytics
Metric
Support
Notes
Impressions
✓
Supported
Likes
✓
Supported
Comments / replies
✓
Supported
Shares / reposts
✓
Supported
Reach
X
Not exposed per-post
Saves
X
Not exposed by Threads
Video views
X
Not exposed per-post today
Inbox
Threads surfaces replies to your posts. DMs are not part of the Threads API today.
Surface
Support
Notes
Replies to your posts
✓
Source threads_reply
Direct messages (DMs)
X
Not supported by the Threads API
Reply from UniPost
✓
One reply per item supported
Connection modes
Pick the setup that matches how the account is owned. Quickstart is fastest when you publish to your own accounts; White-label is required when your customers bring their own accounts through a branded flow. Full setup details in Quickstart and White-label.
