X (Twitter) Settings

What X supports in Nitty Music Social

Character limits, media rules and how these settings appear in the app.

Settings Schema

When creating a post for X (Twitter), use the following settings schema:

{
  "settings": {
    "__type": "x",
    "who_can_reply_post": "everyone",
    "community": "",
    "made_with_ai": false,
    "paid_partnership": false
  }
}

Fields

Field	Type	Required	Description
__type	string	Yes	Must be x
who_can_reply_post	string	Yes	Who can reply to the post
community	string	No	X Community URL
made_with_ai	boolean	No	Mark the post as containing AI-generated content. Defaults to false
paid_partnership	boolean	No	Mark the post as a paid promotion. Defaults to false
post_type	string	No	post (default) or article
article_title	string	Conditional	Required when post_type is article
article_status	string	Conditional	draft or published. Required when post_type is article
article_cover	object	No	Cover image for the article. Only used when post_type is article

post_type

Value	Description
post	A regular short post. This is the default
article	A long-form X article

Long-form articles

Setting post_type to article publishes an X article instead of a post. The content is then treated as HTML rather than plain text, and these tags are kept: p, h1, h2, h3, ul, ol, li, strong, u, a.

{
  "settings": {
    "__type": "x",
    "post_type": "article",
    "article_title": "Why we rebuilt our scheduler",
    "article_status": "published",
    "article_cover": { "id": "img-123", "path": "https://media.nittymusic.com/uploads/cover.jpg" }
  }
}

Constraints worth knowing:

• The character limit rises to 100,000 in article mode.
• Articles take images only, no video.
• An article saved as a draft cannot have thread replies attached.
• article_title and article_status are both required once post_type is article. Omitting either is a validation error.

who_can_reply_post

Controls who can reply to your post.

Value	Description
everyone	Anyone can reply
following	Only people you follow can reply
mentionedUsers	Only mentioned users can reply
subscribers	Only your subscribers can reply
verified	Only verified accounts can reply

community

Optional X Community URL. Must match the format:

https://x.com/i/communities/1493446837214187523

Leave empty or omit to post to your main timeline.

---

Complete Example

{
  "type": "schedule",
  "date": "2024-12-14T10:00:00.000Z",
  "shortLink": false,
  "tags": [],
  "posts": [
    {
      "integration": {
        "id": "your-x-integration-id"
      },
      "value": [
        {
          "content": "Hello from the Nitty Music Social API! 🚀",
          "image": []
        }
      ],
      "settings": {
        "__type": "x",
        "who_can_reply_post": "everyone",
        "community": "",
        "made_with_ai": false,
        "paid_partnership": false
      }
    }
  ]
}

Thread Example

Create a thread by adding multiple items to the value array:

{
  "type": "schedule",
  "date": "2024-12-14T10:00:00.000Z",
  "shortLink": false,
  "tags": [],
  "posts": [
    {
      "integration": {
        "id": "your-x-integration-id"
      },
      "value": [
        {
          "content": "1/ This is the first tweet in my thread",
          "image": []
        },
        {
          "content": "2/ This is the second tweet",
          "image": []
        },
        {
          "content": "3/ And this is the final tweet!",
          "image": []
        }
      ],
      "settings": {
        "__type": "x",
        "who_can_reply_post": "everyone"
      }
    }
  ]
}