Threads

Post to Threads via API — Schedule, Publish, Analyze

Publish text, images, and video to Threads with topic tags for discovery. Schedule posts days ahead and let CodivUpload handle delivery.

Get Started FreeNo credit card required

Threads API controls

Three content types plus topic tags for algorithmic reach.

Video postspost_type: video

Upload native video to Threads — plays inline in the feed. Supports MP4 up to 5 minutes.

Image postspost_type: image

Post single images to Threads. Multi-image carousel support available for up to 10 images.

Text postspost_type: text

Plain text posts up to 500 characters. Threads is text-first — well-crafted text posts drive the most engagement.

Topic tagthreads_topic_tag

Attach a single topic tag (e.g., 'coding', 'design') to categorize your post and appear in topic-based discovery.

API Example

Threads text post with topic tag

A well-timed text post with a topic tag lands in discovery feeds for that topic — a meaningful organic reach boost on a platform that's still growing.

threads-post.sh
# Schedule a Threads post with topic tag
curl -X POST \
  https://api.codivupload.com/v1/posts \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -d '{
    "profile_name": "my-account",
    "platforms": ["threads"],
    "post_type": "text",
    "description": "Hot take: async > sync for creative teams",
    "threads_topic_tag": "productivity",
    "scheduled_date": "2026-04-03T09:00:00Z"  }'
Setup

Getting Started with Threads

Threads runs on Meta's infrastructure, which means authentication goes through Instagram OAuth. When you connect a Threads account in the CodivUpload dashboard, you'll authorize via your Instagram Business or Creator account that is linked to your Threads profile. There is no separate Threads login — Meta's shared auth layer covers both platforms in a single consent screen.

To get started, open the Integrations page in your CodivUpload dashboard and click Connect Threads. You'll be redirected to Meta's authorization page where you grant CodivUpload permission to publish on your behalf. Once authorized, your Threads profile appears in the profile selector and is immediately available for scheduling.

If your Instagram account is not yet linked to a Threads profile, you'll need to create one first through the Threads mobile app. After the profile exists, the OAuth flow picks it up automatically. CodivUpload stores your access token encrypted at rest (AES-256-GCM) and handles token refresh transparently — you won't need to re-authorize unless you revoke access from Meta's settings.

Strategy

Threads Content Strategy

Threads has a 500-character limit, which sits between Twitter/X's 280 and Bluesky's 300. That extra space matters — you can fit a complete thought with context instead of truncating your message. The platform rewards a conversational, informal tone. Posts that read like they're part of a discussion between peers outperform polished marketing copy.

Cross-posting from Instagram: If you already maintain an Instagram content calendar, Threads is the natural extension. Visual content you post to Instagram Stories or Reels can be repurposed as image or video posts on Threads with a text overlay that adds commentary or behind-the-scenes context. With CodivUpload, add both "instagram" and "threads" to the platforms array in a single API call — the same media and description reach both audiences simultaneously.

Topic tags for discovery: Unlike hashtags on Instagram or Twitter, Threads uses a single topic tag per post. Choose it carefully — the tag places your post in the topic feed where users browse by interest. Broad tags ("design", "productivity") get more impressions; niche tags ("figma-tips", "saas-metrics") attract more engaged readers. Use the threads_topic_tag parameter to set this programmatically.

Engagement tactics that work: Reply to your own posts to create threads (multi-post conversations). Ask direct questions to prompt replies. Share hot takes or contrarian opinions — the algorithm surfaces posts that generate discussion. Posting frequency matters less than consistency; three posts per week at predictable times outperforms daily bursts followed by silence.

Timing: Schedule your Threads posts for when your audience is most active. CodivUpload's scheduling lets you queue posts days or weeks ahead with precise timestamps. Morning posts (8-10 AM in your audience's timezone) and evening posts (7-9 PM) tend to see the highest engagement on text-first platforms.

Cross-Post

Threads via API — cross-post with Instagram

A single API call publishes the same image to both Threads and Instagram. Each platform receives the content through its own native pipeline — the Threads API and Instagram Graph API respectively.

threads-crosspost.sh
# Cross-post to Threads + Instagram
curl -X POST \
  https://api.codivupload.com/v1/posts \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -d '{
    "profile_name": "my-brand",
    "platforms": ["threads", "instagram"],
    "post_type": "image",
    "description": "New feature just shipped. Details in the link.",
    "media_urls": ["https://cdn.example.com/feature.jpg"],
    "threads_topic_tag": "saas",
    "scheduled_date": "2026-04-05T08:30:00Z"  }'

Related resources

Cross-Post to 12 Platforms at Once

Learn how to publish the same content to Threads, Instagram, Twitter/X, and 9 more platforms from a single API call.

Instagram Platform Guide

Since Threads and Instagram share the same OAuth flow, setting up one gives you access to both. See the full Instagram integration guide.

Start posting to Threads for free

2 profiles, 10 uploads/mo on the free plan. Upgrade for unlimited.

Get Started Free

Threads API questions