Threads Text Post & Thread Sequence API

The Threads platform supports text-only posts and thread sequences where multiple posts are chained together. Wahdx Connection provides a dedicated endpoint for thread sequences and supports text-only posting through the standard content post endpoint. Facebook Pages also accept text-only posts — see the text-only posting guide. TikTok and Instagram remain media-only platforms.

Get Started Free View Docs Hub

Text-only post: POST /api/content/post

Send a standard content post request with platform threads and no mediaItems. The content field is required for text-only posts.

const API_BASE_URL = 'https://api.wahdx.com';
const API_KEY = process.env.WAHDX_API_KEY;

const headers = {
  'X-API-Key': API_KEY,
  'Content-Type': 'application/json'
};

// Threads text-only post
await fetch(API_BASE_URL + '/api/content/post', {
  method: 'POST',
  headers,
  body: JSON.stringify(
    {
      "platform": "threads",
      "accountId": "THREADS_ACCOUNT_ID",
      "content": "Threads text-only post — no media needed",
      "threadsSettings": {
        "who_can_reply": "everyone"
      }
    }
  )
});

import os
import requests

API_BASE_URL = 'https://api.wahdx.com'
API_KEY = os.environ['WAHDX_API_KEY']

headers = {
    'X-API-Key': API_KEY,
    'Content-Type': 'application/json',
}

# Threads text-only post
response = requests.post(
    API_BASE_URL + '/api/content/post',
    headers=headers,
    json={
    'platform': 'threads',
    'accountId': 'THREADS_ACCOUNT_ID',
    'content': 'Threads text-only post — no media needed',
    'threadsSettings': {
        'who_can_reply': 'everyone'
    }
},
    timeout=30,
)

# Threads text-only post
curl -X POST "https://api.wahdx.com/api/content/post" \
  -H "X-API-Key: $WAHDX_API_KEY" \
  -H "Content-Type: application/json" \
  --data-raw '{
  "platform": "threads",
  "accountId": "THREADS_ACCOUNT_ID",
  "content": "Threads text-only post — no media needed",
  "threadsSettings": {
    "who_can_reply": "everyone"
  }
}'

Thread sequence: POST /api/content/post/threads

Post multiple linked Threads items in a chain. Each item can contain text only or text with media (image/video). Items are posted sequentially and automatically linked via reply_to_id. Maximum 10 items per sequence.

const API_BASE_URL = 'https://api.wahdx.com';
const API_KEY = process.env.WAHDX_API_KEY;

const headers = {
  'X-API-Key': API_KEY,
  'Content-Type': 'application/json'
};

// Threads thread sequence
await fetch(API_BASE_URL + '/api/content/post/threads', {
  method: 'POST',
  headers,
  body: JSON.stringify(
    {
      "accountId": "THREADS_ACCOUNT_ID",
      "threadItems": [
        {
          "content": "Thread pertama dengan gambar",
          "mediaItems": [
            {
              "url": "https://your-domain.com/threads-photo-1.jpg"
            }
          ]
        },
        {
          "content": "Thread kedua hanya teks"
        },
        {
          "content": "Thread ketiga dengan video",
          "mediaItems": [
            {
              "url": "https://your-domain.com/video-threads.mp4"
            }
          ]
        }
      ],
      "threadsSettings": {
        "who_can_reply": "everyone"
      }
    }
  )
});

import os
import requests

API_BASE_URL = 'https://api.wahdx.com'
API_KEY = os.environ['WAHDX_API_KEY']

headers = {
    'X-API-Key': API_KEY,
    'Content-Type': 'application/json',
}

# Threads thread sequence
response = requests.post(
    API_BASE_URL + '/api/content/post/threads',
    headers=headers,
    json={
    'accountId': 'THREADS_ACCOUNT_ID',
    'threadItems': [
        {
            'content': 'Thread pertama dengan gambar',
            'mediaItems': [
                {
                    'url': 'https://your-domain.com/threads-photo-1.jpg'
                }
            ]
        },
        {
            'content': 'Thread kedua hanya teks'
        },
        {
            'content': 'Thread ketiga dengan video',
            'mediaItems': [
                {
                    'url': 'https://your-domain.com/video-threads.mp4'
                }
            ]
        }
    ],
    'threadsSettings': {
        'who_can_reply': 'everyone'
    }
},
    timeout=30,
)

# Threads thread sequence
curl -X POST "https://api.wahdx.com/api/content/post/threads" \
  -H "X-API-Key: $WAHDX_API_KEY" \
  -H "Content-Type: application/json" \
  --data-raw '{
  "accountId": "THREADS_ACCOUNT_ID",
  "threadItems": [
    {
      "content": "Thread pertama dengan gambar",
      "mediaItems": [
        {
          "url": "https://your-domain.com/threads-photo-1.jpg"
        }
      ]
    },
    {
      "content": "Thread kedua hanya teks"
    },
    {
      "content": "Thread ketiga dengan video",
      "mediaItems": [
        {
          "url": "https://your-domain.com/video-threads.mp4"
        }
      ]
    }
  ],
  "threadsSettings": {
    "who_can_reply": "everyone"
  }
}'

Thread sequence response

The response includes per-item results with publish IDs. Use these IDs with the batch status endpoint to check individual thread item status.

{
  "success": true,
  "accountId": "...",
  "platform": "threads",
  "itemCount": 3,
  "results": [
    { "index": 0, "publishId": "...", "status": "PUBLISH_COMPLETE", "public_post_url": "..." },
    { "index": 1, "publishId": "...", "status": "PUBLISH_COMPLETE" },
    { "index": 2, "publishId": "...", "status": "PUBLISH_COMPLETE" }
  ]
}

Requirements and limits

Keep these constraints in mind when designing thread sequence workflows.

Scope threads_content_publish is required for all Threads publishing.
Maximum 10 items per thread sequence.
Each thread item counts toward the 250 post/user/24h Threads rate limit.
Content is required for text-only thread items (max 500 characters per item).
Media validation is applied per-item: single video or multiple images.
ThreadsSettings (who_can_reply) applies to the entire sequence.

FAQ

Common questions about this API topic.

Can I post text-only to TikTok or Instagram?

No. TikTok and Instagram require media. Text-only posting is supported on Threads and Facebook Pages — see the text-only posting guide at /docs/text-posts.

How are thread sequence items linked?

Each item is posted sequentially and linked to the previous via reply_to_id. The publish result of item N is used as reply_to_id for item N+1.

Can I mix text-only and media items in one thread sequence?

Yes. Each item in the threadItems array can be text-only or include mediaItems with images/video.

Does thread sequence work with scheduled posts?

Yes. Include threadItems in the POST /api/posts payload with platform: "threads" and mediaType: "text".

Related docs

Continue with another integration topic.

Authenticate Wahdx Connection API Requests

Learn how to authenticate Wahdx Connection API requests with X-API-Key and keep keys secure in backend or server-side environments.

List Connected Social Accounts with the Public API

Use GET /api/content/accounts to list TikTok, Instagram, Threads, and Facebook accounts connected to a Wahdx Connection workspace using an API key.

Video Requirements for Social Publishing API Workflows

Review recommended video formats, size, duration, aspect ratio, and thumbnail settings for Wahdx Connection publishing workflows.

Photo Carousel Publishing API Guide

Learn how to prepare photo carousel posts, cover images, title fields, and media arrays for Wahdx Connection publishing workflows.