X (Twitter)
280-character posts, image / video, threading. The X API v2 mechanics and what counts as one tweet vs a thread.
X publishes through the X API v2. The integration covers personal accounts, business profiles, and verified accounts equally.
What you can post
| Type | Supported | Notes |
|---|---|---|
| Text post | ✓ | 280 characters (free) / 25,000 (Premium) |
| Single image | ✓ | JPG / PNG / WebP / GIF, up to 5 MB |
| Carousel (multi-image) | ✓ | 2-4 images |
| Video | ✓ | MP4, up to 512 MB, 2:20 (free) / 3 hours (Premium+) |
| Thread | ✓ | Reply chain of any depth |
| Poll | — | Not exposed via API for third-party clients |
Character limit logic
The 280-character cap is the practical default. Premium and Premium+ subscribers can post up to 25,000 characters per tweet, and our editor adapts based on the account's subscription tier (we detect this at connect time and respect it).
Links auto-shorten to a fixed 23 characters in the counter, same as X's in-app composer.
Media specs
- Image: JPG, PNG, WebP, GIF (animated GIFs supported as a single attachment). Max 5 MB.
- Video: MP4 H.264. Max 512 MB. Length depends on tier:
- Free: 2 minutes 20 seconds
- Premium: 10 minutes
- Premium+: 3 hours
Threading
Threads on X are sequential reply chains. To schedule a thread in Post Mate:
- Write the first post.
- Click Add tweet to add the next one.
- Continue as deep as you like.
We publish the thread in sequence, ~1 second apart per tweet. X's API is fine with this pacing; faster than that occasionally trips their rate limiter on big threads.
Per-post settings we expose
- Reply settings — Everyone, Verified accounts, Followed users, or Mentioned only.
- Community — if your X account belongs to a Community, you can target the post to that Community.
What we don't support
- Polls — X doesn't expose poll creation to third-party apps. Use the X app directly.
- Spaces — audio rooms are a different product surface; no scheduling integration.
- Quote-posts — currently not in the v2 API for write operations. We're tracking; will add when X exposes it.
Common rejection reasons
403 Forbidden — You currently have access to a subset of X API V2 endpoints— your X developer app is on the wrong tier. We surface a helper link to fix this in the dashboard.Tweet text exceeds the limit— over the character cap for your subscription tier. Trim or upgrade.Duplicate content— X blocks reposting an identical tweet within ~24 hours. Tweak the text and reschedule.