Threads - SocialAPI.AI

Available Managed connector - SocialAPI handles the Meta Threads App and platform app review for you. No customer-side Meta for Developers registration required. See Platform credentials. Threads is fully supported for posts, comments, moderation, and publishing.

At a glance

Field	Value
Platform slug	`threads`
Auth type	OAuth 2.0 (Meta)
API	Threads Graph API
Best for	Text-first posting and replying on Threads.

Capabilities

Feature	Supported	Notes
List posts	Yes	Text posts, images, videos, carousels
Comments	Yes	Replies to a specific post
Reply to comment	Yes
Comment replies (thread)	Yes	Fetch the reply thread under a comment
Moderate comment (hide/unhide/delete)	Yes	Hide, unhide, and delete supported. Unknown actions return `501`.
Toggle post comments	No	Not supported by Threads API
DMs	No	Not supported by platform
Reviews	No	Not applicable
Mentions	Webhook only	Received via inbound webhook (field: mentions). Requires Advanced Access and threads_manage_mentions scope. No polling endpoint.
Create post	Yes	Text, images, videos, carousels
Delete post	Yes
Update post	No	Not supported by Threads API

Connecting

curl -X POST https://api.social-api.ai/v1/accounts/connect \
  -H "Authorization: Bearer $SOCAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "platform": "threads",
    "redirect_uri": "https://app.example.com/oauth/callback",
    "state": "session_abc123"
  }'

Response:

{
  "auth_url": "https://threads.net/oauth/authorize?client_id=...&state=...",
  "state": "4a8f2c1e9b3d7f06a5c2e8b4d1f3a7e2"
}

Redirect your user to auth_url. After they authorize, SocialAPI exchanges the code with Threads and redirects the user to your redirect_uri with the connection result. See OAuth flows for the redirect parameters.

Reading samples

List posts

curl "https://api.social-api.ai/v1/accounts/{id}/posts?limit=10" \
  -H "Authorization: Bearer $SOCAPI_KEY"

Sample response:

{
  "data": [
    {
      "id": "17895695668004550",
      "platform": "threads",
      "caption": "Hello from Threads!",
      "media_type": "TEXT_POST",
      "permalink": "https://www.threads.net/@acmecorp/post/ABC123",
      "timestamp": "2026-03-01T12:00:00Z",
      "like_count": 18,
      "comments_count": 3,
      "account_id": "acc_01HZ9X3Q4R5M6N7P8V2K0W1J"
    }
  ],
  "count": 1
}

List comments on a post

curl "https://api.social-api.ai/v1/accounts/{id}/posts/17895695668004550/comments?limit=10" \
  -H "Authorization: Bearer $SOCAPI_KEY"

Publishing

Create a Threads post with optional platform-specific fields:

curl -X POST https://api.social-api.ai/v1/posts \
  -H "Authorization: Bearer $SOCAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Hello from Threads!",
    "targets": [
      {
        "account_id": "acc_01HZ9X3Q4R5M6N7P8V2K0W1J",
        "platform_data": {
          "reply_control": "accounts_you_follow"
        }
      }
    ]
  }'

For the full field reference, media constraints, and error recovery, see Threads posts.

Limitations and gotchas

Moderation. Hide, unhide, and delete are supported. Unsupported moderation actions return 501.
No post updates. Threads does not support editing published posts. Use delete and re-create if needed.
Publishing. Supports text posts, single images, single videos, and carousel posts.
Token refresh. Threads tokens can expire. SocialAPI handles refresh automatically. If you receive 401 with code: "platform.threads.auth", reconnect the account.

Permissions

SocialAPI’s managed Meta Threads App already requests these scopes on your behalf: threads_basic, threads_content_publish, threads_read_replies, threads_delete. You don’t need to apply for any platform app review. See Platform credentials.

​At a glance

​Capabilities

​Connecting

​Reading samples

​List posts

​List comments on a post

​Publishing

​Limitations and gotchas

​Permissions

​Related