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

X

X publishes text, photo and video. Text-only posts are allowed (text). Media accepted: images and video. Comments can be read, and you can reply, hide and like them. Direct messages are not available. Post metrics are available. A first comment can be posted right after publishing. Publishing is metered in credits rather than a daily cap.

Post types

TypeAPI valueWhat it publishesMedia itemsAccepts
TexttextText only.NoneText only
PhotophotoOne or more images.1 to 4Images
VideovideoOne video.1Video

Media requirements

Photo (photo)

  • Images: up to 5 MB, aspect ratio 0.1:1 to 10:1, at least 320 px wide.

Video (video)

  • Video: up to 512 MB, 0.5 s to 140 s long, aspect ratio 0.33:1 to 3:1.

Text limits

FieldLimitUnitNote
caption280weighted charactersA link counts as 23 characters and an emoji as 2.
firstComment2,200characters

Settings

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

eksis optionFieldTypeValuesRequiredApplies to
Who can reply: Who can reply.settings.replySettingsstringeveryone, following, mentionedUsersNoAll types
Made with AI: Label the post as containing AI-generated media.settings.madeWithAibooleanNoAll types

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": {
    "replySettings": "following",
    "madeWithAi": false
  }
}

Comments and messages

  • First comment: supported.
  • Comments: read, reply, hide and like.
  • New comments reach eksis: checked every 10 minutes.
  • Private reply to a comment: not supported.
  • Direct messages: not available. eksis does not ask X for access to your direct messages.

Analytics

  • Post metrics: reach, likes, comments, shares, saves, profileVisits.
  • Audience: follower count is tracked.

Good to know

  • Publishing is paid in X credits. A caption with a link costs more, and a first comment is a second paid post.
  • A post waits when the workspace runs out of X credits.

Webhook events

Events a X channel can send to your webhook endpoints:

Rules verified on September 5, 2026.

On this page