Threads

Publish text posts, images, videos, carousels and chains of connected posts to Threads, with a topic tag and a first reply. The same account reads post metrics and manages the replies people leave. The platform id is threads.

#What you can do

#Connect

Threads profiles belong to Instagram accounts, so the user signs in with the Instagram Business or Creator account that owns the Threads profile. Start with GET /v1/connect/threads and a profileId, then send the user to authUrl.

Because Threads depends on Instagram, an Instagram account that is restricted or loses access also stops publishing to Threads. If a Threads post fails with "Instagram account is restricted", fix the Instagram account first.

#Post types

Threads accepts text with no media, which makes it one of the easiest places to cross-post short updates.

curl -X POST https://api.pozy.ai/v1/posts \
  -H "Authorization: Bearer $POZY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Small teams ship faster when the default answer to a meeting is no.",
    "platforms": [{
      "platform": "threads",
      "accountId": "6720c1a94f3b2e0018d4a7f7",
      "platformSpecificData": { "topic_tag": "Startups" }
    }],
    "publishNow": true
  }'

const res = await fetch("https://api.pozy.ai/v1/posts", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.POZY_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    content: "Small teams ship faster when the default answer to a meeting is no.",
    platforms: [{
      platform: "threads",
      accountId: "6720c1a94f3b2e0018d4a7f7",
      platformSpecificData: { topic_tag: "Startups" },
    }],
    publishNow: true,
  }),
});
const data = await res.json();
if (!res.ok) throw new Error(data.error);

console.log(data.post.platforms[0].platformPostUrl);

import os, requests

resp = requests.post(
    "https://api.pozy.ai/v1/posts",
    headers={"Authorization": f"Bearer {os.environ['POZY_API_KEY']}"},
    json={
        "content": "Small teams ship faster when the default answer to a meeting is no.",
        "platforms": [{
            "platform": "threads",
            "accountId": "6720c1a94f3b2e0018d4a7f7",
            "platformSpecificData": {"topic_tag": "Startups"},
        }],
        "publishNow": True,
    },
)
print(resp.json()["post"]["platforms"][0]["platformPostUrl"])

#Thread sequence

threadItems publishes a chain: item 0 is the first post and each later item replies to the one before. Every item can carry text, media or both (text is optional when there is media). When threadItems is set, the top-level content is stored in Pozy for display and search but not published.

{
  "platform": "threads",
  "accountId": "6720c1a94f3b2e0018d4a7f7",
  "platformSpecificData": {
    "threadItems": [
      { "content": "What we learned shipping a mobile app with two engineers.", "mediaItems": [{ "type": "image", "url": "https://cdn.example.com/app-cover.jpg" }] },
      { "content": "1. One codebase. We never regretted it." },
      { "content": "2. A weekly release train, even when the train was half empty." },
      { "content": "3. Support tickets in the team channel, not a separate tool." }
    ]
  }
}

#Platform fields

Schema: ThreadsPlatformData.

#Media requirements

Threads fetches media the same way Instagram does. Media URLs must return the file itself (cloud-drive sharing links fail), and WebP images can fail, so send JPEG or PNG. Images over 8 MB are compressed automatically.

#Limits

The API cannot create polls or quote posts, search GIFs, edit a published post, show who liked or reposted, or like replies.

#Analytics

GET /v1/analytics?platform=threads returns views, likes, comments (replies) and shares per post. Threads has no impressions metric, so use views as the reach figure. shares adds reposts and quotes together.

#Inbox

Threads has no DMs. Replies to your posts show up as comments. A comment on Threads is itself a reply to the post, so calling Reply to comment without a commentId replies to the post itself, and with one it answers that reply. You can delete replies, and hide or unhide them. Liking replies is not supported.

New replies are picked up by polling, so automated replies can lag by a few minutes.

#Errors you may see

A rejected publishNow: true post returns 207 with post.status: "failed" and the reason in platforms[].errorMessage.

#Endpoints

#Webhook events