Skip to main content

​
Overview

Postiz provides comprehensive X (Twitter) integration with support for tweets, threads, media uploads, and advanced automation features like auto-reposting and engagement tracking.
Business Account Note: You will be logged into your current X account. To use a different account, switch accounts on X first before connecting.

​
Authentication

X uses OAuth 1.0a authentication with write access permissions.
1

Connect Account

Click “Connect X” in the Integrations settings
2

Authorize Postiz

You’ll be redirected to X to authorize the application with write access
3

Complete Setup

After authorization, your X account will be connected and ready to use

​
Supported Features

​
Text Posts

  • Free users: 200 characters maximum
  • Premium users: 4000 characters maximum
  • Rich text formatting not supported (plain text only)
  • URL shortening handled automatically by X

​
Media Attachments

  • Maximum: 4 images per tweet
  • Format: JPG, PNG, GIF (converted and optimized)
  • Size: Automatically resized to 1000px width
  • GIF Support: Animated GIFs preserved
Content Rules:
  • Maximum 4 pictures OR maximum 1 video
  • Cannot mix images and videos in the same tweet
  • Posts can also be text-only without attachments

​
Threads & Comments

  • Create multi-tweet threads by adding comments
  • Each comment becomes a reply to the previous tweet
  • Comments support the same media rules as main tweets
  • Threading handled automatically by Postiz

​
Post Settings

Control who can reply to your tweets:
  • Everyone (default)
  • People you follow
  • Mentioned users only
  • Verified users only
  • Subscribers only
Post directly to X Communities by providing the community URL

​
Advanced Features

​
Auto-Repost High-Performing Tweets

Automatically repost tweets that reach a certain engagement threshold. 
{
  identifier: 'x-autoRepostPost',
  title: 'Auto Repost Posts',
  settings: {
    likesAmount: 100, // Minimum likes to trigger repost
    checkInterval: 6 hours,
    maxRuns: 3
  }
}
How it works: Postiz monitors your tweets (1 week old posts only) and automatically reposts them when they reach your specified like threshold. This increases visibility and engagement.

​
Auto-Plug Posts

Add promotional replies to high-performing tweets. 
{
  identifier: 'x-autoPlugPost',
  settings: {
    likesAmount: 50,
    plugMessage: "Your promotional message here"
  }
}

​
Add Re-posters

Automatically repost your content from multiple X accounts to increase reach.

​
Analytics

Postiz provides comprehensive analytics for your X account:

​
Account Metrics

  • Impressions: Total tweet views
  • Engagement: Likes, retweets, quotes, replies
  • Bookmarks: Number of bookmarks
  • Profile visits: Track profile engagement

​
Per-Post Metrics

  • Impressions
  • Likes
  • Retweets
  • Replies
  • Quotes
  • Bookmarks
  • Real-time updates
Analytics are disabled if DISABLE_X_ANALYTICS environment variable is set.

​
Rate Limits

Critical Rate Limit: X has strict rate limits of 300 posts per 3 hours. Postiz automatically manages this with a maxConcurrentJob setting of 1.

​
Common Errors

ErrorCauseSolution
Usage cappedRate limit exceededWait before posting again
Duplicate postAlready posted this contentWait or modify content
Invalid URLURL not allowed on XCheck URL format
Video too longVideo exceeds 2 minutesUpgrade to Premium or shorten video
Authentication expiredToken expiredReconnect your account

​
Mentions

Mention users in your tweets with the @username format. Postiz provides autocomplete:
  1. Type @ followed by a username
  2. Search results show matching profiles
  3. Select a user to insert the mention

​
Best Practices

Optimal Posting Times

Schedule posts during peak engagement hours (9 AM - 3 PM local time)

Use Media Wisely

Tweets with images get 150% more engagement than text-only

Thread Strategy

Use threads for detailed content - improves visibility in algorithm

Monitor Analytics

Check which content performs best and replicate successful patterns

​
Troubleshooting

If you see “Unsupported Authentication” errors:
  • Disconnect and reconnect your account
  • Ensure you’re logged into the correct X account
  • Check that you authorized write permissions
Common video issues:
  • Ensure video is under 2 minutes (free users)
  • Use MP4 format only
  • Check file size isn’t too large
  • Verify account isn’t rate limited
X blocks duplicate tweets within a short timeframe:
  • Wait at least 24 hours between identical posts
  • Modify content slightly for reposts
  • Use different wording or add timestamps

Build docs developers (and LLMs) love

Get started for freeTalk to us