Threads

​

Quick reference

​

Before you start

• threads_basic — read profile.
• threads_content_publish — publish threads.
• threads_manage_replies + threads_read_replies — first-comment + inbox replies.
• threads_manage_insights — analytics.

​

Quick start

import Postbreeze from "@postbreeze/node";

const postbreeze = new Postbreeze({ apiKey: process.env.POSTBREEZE_API_KEY! });

await postbreeze.posts.create({
  content: "Threads is hitting a different stride lately. Anyone else feel it?",
  scheduledFor: new Date(Date.now() + 30_000).toISOString(),
  platforms: [{ accountId: "soc_threads_…" }],
});

​

Content types

​

Text-only

const post = await postbreeze.posts.create({
  content: "Threads is hitting a different stride lately. Anyone else feel it?",
  scheduledFor: new Date(Date.now() + 30_000).toISOString(),
  platforms: [{
    accountId: "soc_threads_…",
    platformOptions: { platform: "THREADS", kind: "TEXT" },
  }],
});

​

Single image

​

Single video

​

Carousel (2–20 items, mixed media)

const post = await postbreeze.posts.create({
  content: "Behind the scenes from this week's shoot — slide for the video 👇",
  mediaIds: ["med_img_1", "med_img_2", "med_video_1", "med_img_3"],
  scheduledFor: new Date(Date.now() + 30_000).toISOString(),
  platforms: [{
    accountId: "soc_threads_…",
    platformOptions: { platform: "THREADS", kind: "CAROUSEL" },
  }],
});

​

Multi-post threads (threadParts)

await postbreeze.posts.create({
  content: "Quick thread on what we shipped this week 🧵",
  platforms: [{
    accountId: "soc_threads_…",
    platformOptions: {
      platform: "THREADS",
      threadParts: [
        "1/ The new compose flow",
        "2/ Per-platform thread editing",
        "3/ Connected previews",
      ],
    },
  }],
});

const post = await postbreeze.posts.create({
  content: "Quick thread on what we shipped this week 🧵",
  scheduledFor: new Date(Date.now() + 30_000).toISOString(),
  platforms: [{
    accountId: "soc_threads_…",
    platformOptions: {
      platform: "THREADS",
      threadParts: [
        "1/ The new compose flow — faster, calmer, fewer tabs",
        "2/ Per-platform thread editing — tune Threads without breaking IG",
        "3/ Connected previews — see exactly what ships before it ships",
      ],
    },
  }],
});

​

Constraints

• Each part ≤ 500 characters. The root caption and every follow-up share the same Threads cap — there’s no “See more” fold to lean on.
• Up to 25 follow-ups. threadParts.length is capped at 25; for longer chains, split into multiple posts.
• Follow-ups are text-only. Media (images, videos, carousels) stays on the root post. Thread parts cannot carry attachments.
• firstComment replies to the root, not the last part. If you set both threadParts and firstComment, the first comment is posted as a reply to the root post (alongside threadParts[0]), not chained at the end of the thread.
• Thread follow-ups count toward the reply quota. Threads enforces 1,000 replies / 24h per account; a 25-part thread burns 25 of those.

​

Media requirements

​

Images

​

Videos

​

Platform-specific fields

​

First comment

platforms: [{
  accountId: "soc_threads_…",
  platformOptions: { platform: "THREADS", kind: "TEXT" },
  firstComment: "Link in bio for the full story",
}]

​

Analytics

​

Common errors

​

What you can’t do

• ❌ Quote-post via API (Threads doesn’t expose this surface)
• ❌ Reply target in compose (Postbreeze v1 only reply-to-incoming; cold-start reply is deferred)
• ❌ Attach media to threadParts follow-ups (text-only by design — media stays on the root)
• ❌ Schedule via Threads’ native scheduler
• ❌ Edit a post after publish
• ❌ Polls
• ❌ Stories
• ❌ Webhook subscriptions (polling-only for now in Postbreeze)

​

Full control: nested shape

const post = await postbreeze.posts.create({
  caption: "Quick thread on what we shipped this week 🧵",
  scheduledAt: new Date(Date.now() + 30_000).toISOString(),
  targets: [{
    socialAccountId: "soc_threads_…",
    platformOptions: {
      platform: "THREADS",
      threadParts: [
        "1/ The new compose flow",
        "2/ Per-platform thread editing",
        "3/ Connected previews",
      ],
    },
  }],
});