step by step
How to post to Threads with the API
Create a key, connect Threads, then schedule a post.
Open Dashboard → AI & API, create a key, and send it as Authorization: Bearer pw_live_…. Connect your Threads account if you have not already.
Endpoints
API base URL
https://postwing.io/api/v1Docs
https://postwing.io/docsCall POST /posts/preview with a caption, time, platforms: ["threads"], and optional media. Full field reference is in the API docs.
curl -s -X POST "https://postwing.io/api/v1/posts/preview" \
-H "Authorization: Bearer pw_live_…" \
-H "Content-Type: application/json" \
-d '{
"caption": "Update from the Threads posting API",
"scheduled_at": "2026-10-05T18:00:00Z",
"platforms": [
"threads"
],
"media_items": [
{
"url": "https://cdn.example.com/post.jpg",
"type": "image"
}
]
}'what you can do
Threads posting from one API
Same PostWing API as the full product, scoped to Threads when you set platforms to threads.
- Schedule Threads text, image, and video posts
- Upload media with a direct upload URL
- Use per-account captions when you need them
- Preview → confirm so nothing schedules without approval
- Edit or cancel scheduled Threads posts from the same API
built for Threads
Text and media in one flow
Set a caption, optional media, pick a time, and target Threads. No extra platform options beyond the caption.
- Images for visual Threads posts
- Video posts when you need motion
- Scheduled posts show up on your PostWing calendar
Threads options
Keep it simple
Threads uses caption only. No extra platform_options fields are required.
- Preview → confirm so nothing schedules without approval
- API key or OAuth with scoped access
one API
Same API for every network
There is no separate Threads product. Pass platforms or targets[] on the same preview → confirm flow. Add Instagram, TikTok, YouTube, LinkedIn, X, Facebook, Pinterest, or Threads without changing your integration.
- Threads
- YouTube
- TikTok
- X (Twitter)
Connect accounts once in PostWing (or via the accounts endpoints)
Call POST /posts/preview with the networks you want on that post
Confirm with the token. One key covers every platform PostWing supports.
questions
Threads posting API FAQ
Yes. Send media_items with type image or video, set platforms to threads, then preview and confirm.