Threads

Threads is supported in V1 for OAuth connect, publishing, and scheduling. Inbox, analytics, and automations are available for Instagram and Facebook only today.

Connect an account

1. Create a Meta app with the Access the Threads API use case in the Meta Developer Portal
2. Under Use cases → Access the Threads API → Settings, add your OAuth redirect URI (all three URL fields are required to save)
3. Add your Threads account as a Threads Tester and accept the invite under Threads → Website permissions → Invites
4. Set THREADS_APP_ID and THREADS_APP_SECRET on your Aether deployment (use the Threads app ID from the use case settings, not the generic app ID)
5. Generate a Connect Link with "platform": "threads"

Content types

Threads supports text posts, single images, single videos, carousels (2–10 items), and multi-post threads via overrides.

{
  "text": "Launch day thread 🧵",
  "profileIds": ["prof_th123"],
  "mediaUrls": ["https://cdn.example.com/hero.jpg"]
}

Threads-specific overrides

Use overrides.threads:

{
  "text": "Thread intro (display only when threadItems is set)",
  "profileIds": ["prof_th123"],
  "overrides": {
    "threads": {
      "topicTag": "productlaunch",
      "threadItems": [
        { "text": "First post in the thread" },
        { "text": "Second post — published as a reply" }
      ]
    }
  }
}

Cross-posting with Instagram

Pass multiple profileIds in one POST /posts call to publish to Threads and Instagram simultaneously. Use per-platform overrides when formatting differs.

Media requirements

• Images: JPEG, PNG
• Video: MP4 or MOV (up to 5 minutes)
• Upload via presigned URLs before attaching mediaUrls

Rate limits

Threads applies 250 API calls per 24 hours per token. Aether queues scheduled posts and surfaces limit errors when a publish would exceed platform quotas.

Not yet available for Threads