Skip to content

X settings

X takes the widest settings object of any provider, because it publishes two different things: regular posts and long-form articles.

Field Required Description
who_can_reply_post Yes, unless post_type is article One of everyone, following, mentionedUsers, subscribers, verified.
post_type No post for a regular short post, article for a long-form X article. Defaults to a regular post.
community No A community URL in the exact form https://x.com/i/communities/1234567890. An empty string is also accepted.
article_title Yes when post_type is article The article’s title. At least one character.
article_status Yes when post_type is article draft to save it on X as a draft, published to publish it.
article_cover No Cover image for the article, as a media object. Only used for articles.
made_with_ai No Boolean. Labels the post as AI generated.
paid_partnership No Boolean. Labels the post as a paid partnership.
"settings": {
"who_can_reply_post": "everyone"
}
"settings": {
"who_can_reply_post": "everyone",
"community": "https://x.com/i/communities/1493446837214187523"
}

The URL format is checked strictly. Anything that is not exactly https://x.com/i/communities/ followed by digits is rejected.

"settings": {
"post_type": "article",
"article_title": "What we shipped this quarter",
"article_status": "published",
"article_cover": {
"id": "media-id",
"path": "https://media.example.com/cover.png"
}
}
  • A post can carry up to 4 pictures or one video, or no media at all.
  • An article takes pictures only. A video in an article is refused with X articles only support images.
  • Text is limited to 280 characters, or 4000 when Verified is on in the channel’s Additional Settings. An article can run to 100000 characters.

A thread is not a setting. Put each part in its own entry of the post’s value array and they publish as a chain. See create a post.

An article can have replies only when article_status is published. A draft article with replies is refused with A draft article cannot have thread replies, remove them or publish the article.