Threads
Overview
Connect Threads, scopes, capabilities, and known limits.
Onepostly maps the Threads API into the same /v1/* surface as other platforms. This section covers Threads-only behavior.
In this section
| Page | Topics |
|---|---|
| Posts | Publish text, image, video, multi-image; threads; quotes; schedule; delete |
| Comments | List, create, delete replies |
| Engagement | Repost / unrepost |
| Insights | Analytics / normalized metrics |
Cross-platform API flow: Media, Webhooks.
Connect
- Dashboard → Connections → connect Threads
- Approve scopes in the Threads consent screen
- Resolve
connectionIdwith your API key:
curl https://api.onepostly.com/v1/connections \
-H "x-api-key: op_YOUR_KEY"Use the matching row’s id (where platform is "threads") as connectionId in publish requests.
After scope upgrades, reconnect Threads so the new scopes appear on the token.
OAuth scopes
| Scope | Used for |
|---|---|
threads_basic | Profile / account identity |
threads_content_publish | Publish posts |
threads_read_replies | List replies on a post |
threads_manage_replies | Reply moderation / create replies |
threads_manage_insights | Media insights / analytics |
threads_delete | Delete posts and replies |
Threads Login. Connected accounts stay usable while tokens remain valid. Reconnect if you see TOKEN_INVALID.
Tokens
- Long-lived user token (~60 days)
- Invalid / expired token →
TOKEN_INVALID→ reconnect
Auth errors
| Code | Meaning |
|---|---|
TOKEN_INVALID / 401 | Expired or invalid token → reconnect |
PERMISSION_DENIED / 403 | Missing scope → reconnect with the required scopes |
Capabilities
| Action | Supported | Notes |
|---|---|---|
| Create post | Yes | POST /v1/posts |
| Text-only | Yes | Max 500 characters |
| Image | Yes | Single image URL + optional text |
| Video | Yes | mediaKind: "video" |
| Multi-image | Yes | 2–20 image/video URLs |
| Stories | No | Rejected as UNSUPPORTED_MEDIA_KIND |
| Thread / quote | Yes | thread[] + quoteTweetId |
| Schedule | Yes | scheduledFor + timezone |
| Remote delete | Yes | Requires threads_delete |
| Insights | Yes | views, likes, replies, reposts, quotes, shares |
| List comments (replies) | Yes | |
| Create / delete comment | Yes | |
| Repost (retweet) | Yes | |
| Like / bookmark | No | No official Threads like/bookmark API |
Known limitations
- Media URLs must be public HTTPS
- Text is limited to 500 characters (
TEXT_TOO_LONGif exceeded) - Stories are not supported on Threads
- Distinct from Instagram Business Login