The API reference moved here from eksis.io/developers.

Threads

Threads publishes text, photo, video and carousel. Text-only posts are allowed (text). Media accepted: images and video. Comments can be read, and you can reply and hide them. Direct messages are not available. Post metrics are available. A first comment can be posted right after publishing. eksis publishes at most 50 posts per account per rolling 24 hours.

Threads is marked as under maintenance in eksis right now, so posts to it may not go out. The rules below apply once it is back.

Post types

TypeAPI valueWhat it publishesMedia itemsAccepts
TexttextText only, with an optional link preview card.NoneText only
PhotophotoOne image.1Images
VideovideoOne video.1Video
CarouselcarouselSeveral images or videos in one swipeable post.2 to 20Images and video, mixed

Media requirements

Photo (photo)

  • Images: up to 8 MB, aspect ratio 0.1:1 to 10:1, at most 1440 px wide.

Video (video)

  • Video: up to 1 GB, 1 s to 5 min long, aspect ratio 0.01:1 to 10:1.
  • Images: up to 8 MB, aspect ratio 0.1:1 to 10:1, at most 1440 px wide.
  • Video: up to 1 GB, 1 s to 5 min long, aspect ratio 0.01:1 to 10:1.

Text limits

FieldLimitUnitNote
caption5itemsUnique links per post.
firstComment2,200characters

Settings

Options for Threads go in targets[].settings of create and update post requests.

eksis optionFieldTypeValuesRequiredApplies to
Who can reply: Who can reply.settings.replyControlstringeveryone, accounts_you_follow, mentioned_onlyNoAll types
Link preview: Link shown as a preview card. Text posts only; empty means no card.settings.linkAttachmentNotext

A value of the wrong type, or outside the allowed values, is refused with 422 and the code validation.failed, drafts included. An unknown key is dropped and reported in data.warnings.

Example target
{
  "channelId": "CHANNEL_ID",
  "contentType": "text",
  "settings": {
    "replyControl": "everyone"
  }
}

Comments and messages

  • First comment: supported.
  • Comments: read, reply and hide.
  • New comments reach eksis: pushed by Threads.
  • Private reply to a comment: not supported.
  • Direct messages: not available. Threads has no direct message API yet.

Analytics

  • Post metrics: likes, shares.
  • Audience: follower count is tracked.

Daily limit

eksis publishes up to 50 posts per Threads channel a day. Threads itself allows 250 posts per account a day. A post over the limit is postponed, not failed.

Good to know

  • linkAttachment is only used on text posts.
  • A first comment is posted as a reply to the post.

Webhook events

Events a Threads channel can send to your webhook endpoints:

Rules verified on September 5, 2026.

On this page