Threads — Postli docs

Home / Docs / Threads

Provider

Threads

Publish text-first posts (with optional image or video) to Meta’s Threads platform. Postli connects to Threads through its own OAuth flow — the account’s linked Instagram identity carries through.

Requirements

A Threads account — created via the Threads app or web, linked to your Instagram identity.
Threads accounts based on Personal Instagram are supported; Business / Creator Instagram accounts are required for engagement-insight reads.

Spec

Account type

Any Threads account

Auth

Threads OAuth (Meta) — separate from Facebook Login

Token type

Short-lived (1 hour) + long-lived (60 days). Postli refreshes automatically.

Post types

Text, image, video, reply

Character limit

Up to 500 characters

Image

JPEG, PNG · ≤8 MB

Video

MP4, MOV · ≤1 GB · 0–5 min

Carousel

Not supported by the API (single media per post)

Auto-comments

Supported via self-reply (Instant, Time)

Connect your Threads account

Postli manages the OAuth app centrally — you don’t need to create a developer app or paste any API credentials. Go to Integrations → Threads → Connect and approve the permissions on the Threads OAuth dialog. Note that Threads has its own OAuth flow even though it shares Meta’s identity backend — this is separate from connecting Facebook or Instagram.

Scopes Postli requests:

threads_basic # read profile threads_content_publish # publish posts threads_manage_insights # engagement threads_manage_replies # auto-comments via reply threads_read_replies # read reply threads

Post types in detail

Text post

Up to 500 characters. URLs render as a card if Meta’s crawler can scrape OG tags from the destination; otherwise as plain link text.

Image post

One image plus optional caption. Threads does not currently support image carousels via API.

Video post

One video plus optional caption. Videos are uploaded via Threads’ container-based publishing flow — Postli handles the upload, polls until the container is ready, then publishes.

Reply

Used internally for auto-comments. You can also draft a reply explicitly by linking to a parent Threads post URL.

Auto-comments

Implemented as self-replies. Instant and Time conditions both work. LikeCount depends on the threads_manage_insights scope being granted.

Rate limits

Threads enforces a publishing cap of 250 posts per 24 hours per user. Postli will defer additional posts to the next window. Replies count toward the same cap.

Gotchas & best practices

Separate OAuth from Instagram. Even though the identity is the same, you must run a separate connect flow for Threads.
500-character limit is tight. Cross-posting a longer Instagram caption will fail validation; override the channel-tab content.
No carousel. The API doesn’t yet expose multi-image posts — split into a thread instead.
Insights lag. Engagement metrics from threads_manage_insights can lag by up to 6 hours.

Webhooks

Postli does not subscribe to Threads webhooks. Engagement is polled.