The platform formerly known as Twitter. The API changes have been… eventful. Let’s focus on what works.
Supported Content Types
- Tweets: Text with optional media. 0-4 files.
- Images and videos can be mixed in the same tweet.
Quirks & Gotchas
- Max 4 images per tweet.
- Max 4 videos per tweet (though realistically, 1 is most common).
- Video max size: 512 MB.
Text & Subscription-Based Limits
Twitter/X limits vary based on the account’s subscription tier:
| Tier | Text Limit | Video Duration |
|---|
| Free | 280 chars | 140s (2:20) |
| Basic | 280 chars | 140s (2:20) |
| Premium | 25,000 chars | 600s (10 min) |
| Premium+ | 25,000 chars | 600s (10 min) |
Post Options
Send X-specific options inside data.TWITTER.
| Field | Type | Description |
|---|
text | string | Tweet text. Character limit depends on the account subscription tier. |
uploadIds | string[] | Up to 4 uploaded media files. Images and videos can be mixed. |
replySettings | enum | Controls who can reply. See the values below. |
{
"teamId": "team_123",
"title": "X announcement",
"status": "SCHEDULED",
"postDate": "2026-06-01T15:00:00.000Z",
"socialAccountTypes": ["TWITTER"],
"data": {
"TWITTER": {
"text": "Launching today",
"uploadIds": ["upload_image_123"],
"replySettings": "MENTIONED_USERS"
}
}
}
Reply Settings
You can control who’s allowed to reply to your tweets. Set replySettings in the data.TWITTER object when creating a post.
| Value | Who can reply |
|---|
EVERYONE | Anyone (default) |
FOLLOWING | Only people you follow |
MENTIONED_USERS | Only users mentioned in the tweet |
SUBSCRIBERS | Subscribers only |
VERIFIED | Verified accounts only |
replySettings or set it to EVERYONE, we don’t send the parameter to Twitter at all - which is Twitter’s default behavior.
{
"data": {
"TWITTER": {
"text": "Hot take incoming",
"replySettings": "MENTIONED_USERS"
}
}
}
Reply settings depend on your Twitter/X account tier. Some options (like SUBSCRIBERS) only make sense if your account actually has subscribers. Twitter won’t error out if you use them anyway - it just won’t do much.
Analytics
We’ll be honest here.
Profile Analytics
Status: Not available. Won’t be.
Post Analytics
Status: Not available. Won’t be.
Why? The X API changes have made analytics access extremely expensive and restrictive. The cost-to-value ratio doesn’t make sense for anyone involved. We know, it sucks. If this changes in the future, we’ll add support. But don’t hold your breath.
