Posts

Create a postCopy Anchor Link

POST /v1/posts
Authorization: Bearer tb_live_xxx
Idempotency-Key: 6f1c2b7e-0d8a-4f7e-9a51-2c1f7b0e9d34
Content-Type: application/json

{
  "content": "Weekend promo 🎉",
  "media_ids": ["0b9d..."],
  "targets": [{ "account_id": "a1.." }, { "account_id": "b2.." }],
  "scheduled_at": "2026-10-15T09:00:00+07:00"
}

201 response:

{
  "id": "p1..",
  "status": "scheduled",
  "scheduled_at": "2026-10-15T02:00:00Z",
  "targets": [
    {
      "id": "t1..",
      "account_id": "a1..",
      "platform": "instagram",
      "status": "pending",
      "permalink": null
    },
    {
      "id": "t2..",
      "account_id": "b2..",
      "platform": "threads",
      "status": "pending",
      "permalink": null
    }
  ]
}

Publishing runs in the background. Check GET /v1/posts/{id}: each target becomes published with a permalink, or failed with an error_code.

A single video on Instagram publishes as a Reel automatically. Two or more media items become a carousel (Instagram up to 10, Threads up to 20).

A version per accountCopy Anchor Link

Each target can have its own text and/or media (media_ids and/or media_urls). Fields not sent follow the shared version. content: "" means deliberately without text.

{
  "content": "What's your favorite coffee?",
  "targets": [
    { "account_id": "th..", "options": { "poll": { "options": ["Black", "Latte"] } } },
    { "account_id": "ig..", "content": "New on the menu this week ☕", "media_ids": ["m1.."] }
  ]
}

Threads threadsCopy Anchor Link

content is the first post. Each item of options.thread goes out as the next reply, in order (up to 10 follow-up parts). A part is text, or { "text", "media_ids" } / { "text", "media_url" } with 1 photo or video (media_url is downloaded by Tebar like media_urls). If publishing fails partway, a retry continues from the next part without reposting the ones already out. Needs the threads_manage_replies permission (see the table below).

{
  "content": "5 tips for iced latte at home 🧵",
  "targets": [
    {
      "account_id": "th..",
      "options": {
        "thread": [
          "1. Start with a strong espresso.",
          { "text": "2. Cold milk, not hot.", "media_ids": ["m1.."] },
          { "media_url": "https://example.com/latte.mp4" }
        ]
      }
    }
  ],
  "scheduled_at": "2026-10-31T19:30:00+07:00"
}

Options per platformCopy Anchor Link

Sent in targets[].options. Unknown keys are refused (400 invalid_options).

Threads allows 5 unique links per post (400 too_many_links).

Managing postsCopy Anchor Link

A post that has started publishing cannot be changed (409 post_not_editable). To publish a scheduled post now, send PATCH with scheduled_at set to the current time.

To change one account's version or options in a scheduled post, send targets with accounts already in the post. A field sent replaces that account's (options as a whole, so send again the other options you want to keep); content or media_ids set to null make the account follow the shared version again. Accounts cannot be added or removed (400 account_not_in_post).

{
  "targets": [
    { "account_id": "th..", "options": { "thread": ["The new part 2"], "topic_tag": "coffee" } },
    { "account_id": "ig..", "content": null, "media_ids": null }
  ]
}