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/v2Docs
https://postwing.io/docsCall POST /posts with a caption, a time, your Threads account id from GET /accounts, and optional media. Full field reference is in the API docs.
curl -s -X POST "https://postwing.io/api/v2/posts" \
-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",
"accounts": [
{
"id": "THREADS_ACCOUNT_ID"
}
],
"media": [
{
"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 post to a Threads account.
- Schedule Threads text, image, and video posts
- Upload media with a direct upload URL
- Use per-account captions when you need them
- Schedule in one call; edit or cancel any time before it publishes
- 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. There are no extra options.
- Clear errors with a code and the exact field to fix
- API key or OAuth with scoped access
one API
Same API for every network
There is no separate Threads product. List more account ids in accounts on the same call. 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 with every account you want on that post
It is on your calendar. One key covers every platform PostWing supports.
questions
Threads posting API FAQ
Yes. Add images or a video in media and post to your Threads account id.