Skip to main content

​
Overview

Postiz integrates with Meta’s Threads platform to post text, images, videos, and carousels with comprehensive analytics tracking.

​
Authentication

Threads uses Meta’s OAuth 2.0 with long-lived tokens.
1

Connect Threads

Click “Connect Threads” in Integrations
2

Authorize

Grant all requested Threads permissions
3

Auto-Refresh

Tokens auto-refresh every 58 days
For HTTP (non-HTTPS) setups, Postiz automatically redirects through redirectmeto.com for OAuth.

​
Required Permissions

  • threads_basic - Basic account access
  • threads_content_publish - Publish content
  • threads_manage_replies - Manage replies
  • threads_manage_insights - Access analytics

​
Supported Features

​
Content Types

  • Maximum: 500 characters
  • Plain text
  • URLs automatically linked

​
Publishing Process

Threads uses a two-step publishing process:
1

Create Media Container

Upload media and create container with metadata
2

Wait for Processing

Poll status until FINISHED (checks every 2.2 seconds)
3

Publish Thread

Publish the container to make it live
4

Get Permalink

Retrieve post URL
Processing time varies based on media size. Postiz automatically waits for completion.

​
Content Types

{
  media_type: "TEXT",
  text: "Your post content",
  reply_to_id: "optional_parent_id"
}

{
  image_url: "https://example.com/image.jpg",
  // OR
  video_url: "https://example.com/video.mp4",
  media_type: "IMAGE" | "VIDEO",
  text: "Caption"
}

​
Replies & Threading

Create threaded conversations:
1

Main Post

Publish initial thread
2

Reply

Reference parent with reply_to_id
3

Thread Continuation

Continue referencing previous reply

​
Analytics

​
Account-Level Analytics

Track overall performance:
  • Views: Total thread views
  • Likes: Total likes
  • Replies: Reply count
  • Reposts: Repost count
  • Quotes: Quote posts

​
Post-Level Analytics

Detailed per-post metrics:
  • Views
  • Likes
  • Replies
  • Reposts
  • Quotes
Analytics update in real-time. 
{
  "label": "Views",
  "percentageChange": 0,
  "data": [
    {
      "total": "1523",
      "date": "2024-03-15"
    }
  ]
}

​
Automation Features

​
Auto-Plug Posts

Automatically reply to high-performing posts: 
{
  identifier: 'threads-autoPlugPost',
  settings: {
    likesAmount: 100,
    post: "Your promotional message"
  },
  runEveryMilliseconds: 21600000,  // 6 hours
  totalRuns: 3
}
When a post reaches the like threshold, automatically adds your promotional reply.

​
Rate Limits

Threads Rate Limits:
  • 2 concurrent posting jobs
  • Processing time adds delays
  • Moderate API limits
  • No strict daily limits

​
Error Handling

Common Threads errors:
ErrorCauseSolution
Error validating access tokenToken expiredAutomatic refresh/reconnect
Text must be at most 500 charactersCharacter limitShorten text to 500 chars
Processing errorMedia issueCheck media format and size
Status: ERRORUpload failedRetry with different media

​
Best Practices

Character Limit

Keep posts concise - 500 character maximum

Carousel Strategy

Use 3-5 images for optimal engagement

Video Format

Vertical 9:16 videos perform best

Posting Time

Best engagement: 12-3 PM and 6-9 PM

​
Troubleshooting

If media processing takes too long:
  • Large files take longer to process
  • Check media format is supported
  • Try reducing file size
  • Network issues may cause delays
Authentication problems:
  • Tokens refresh automatically every 58 days
  • If refresh fails, reconnect account
  • Check Meta hasn’t revoked access
  • Verify all permissions granted
Analytics issues:
  • Data may take time to populate
  • Check insights permission granted
  • Some metrics only for certain post types
  • Try refreshing after a few hours

Build docs developers (and LLMs) love

Get started for freeTalk to us