X settings
X takes the widest settings object of any provider, because it publishes two different things: regular posts and long-form articles.
Fields
Section titled “Fields”| 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. |
A regular post
Section titled “A regular post”"settings": { "who_can_reply_post": "everyone"}A post limited to a community
Section titled “A post limited to a community”"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.
A long-form article
Section titled “A long-form article”"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" }}Media and length
Section titled “Media and length”- 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.
Threads
Section titled “Threads”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.