Skip to main content
Sign Up
All platforms

Threads API

Threads API Errors

Threads API publishing errors — auth (tied to Instagram), media processing, and video format.

Threads inherits Instagram's auth model entirely — tokens are minted via the Instagram OAuth flow against a linked business account. Most errors mirror Instagram's with simpler shapes.

PostPeer Threads APIView Docs
Authentication3Media1Video3

Authentication

3 errors in this category

revoked_access_tokenAuthentication

Threads access token was revoked.

Why it happens
User removed app permission from Instagram's Apps and Websites settings — Threads tokens are tied to Instagram.
How to fix
Reconnect through the Instagram-business OAuth flow.
How PostPeer handles it
PostPeer surfaces the linked Instagram account in the connect UI so the user knows which permissions to keep granted.
token is invalidAuthentication

Threads token failed validation.

Why it happens
Token expired, revoked, or signed under a stale Instagram app.
How to fix
Reconnect.
session has been invalidatedAuthentication

Session forcibly terminated.

Why it happens
User changed their Instagram password or completed a Meta security check.
How to fix
Reconnect to establish a fresh session.

Media

1 error in this category

media processingMedia

Threads is still processing the uploaded media.

Why it happens
Larger video uploads need processing time before the publish step can run.
How to fix
Poll the container status before publishing. PostPeer does this automatically with a 10-minute backoff window.

Video

3 errors in this category

video formatVideo

Video is not in MP4 with H.264/AAC.

Why it happens
Threads only ingests the same codec set as Instagram.
How to fix
Re-encode with `ffmpeg -i in.mov -c:v libx264 -c:a aac out.mp4`.
video codecVideo

Video uses an unsupported codec (e.g. HEVC/H.265).

Why it happens
HEVC, AV1, and VP9 are rejected by Threads ingestion.
How to fix
Re-encode to H.264.
duration exceedVideo

Video exceeds the 5-minute Threads cap.

Why it happens
Threads caps video at 5 minutes per post.
How to fix
Trim or split into a thread.

Quick reference

All 7 Threads errors in one table — Ctrl/Cmd-F to find yours.

CodeWhat it means
revoked_access_tokenThreads access token was revoked.
token is invalidThreads token failed validation.
session has been invalidatedSession forcibly terminated.
media processingThreads is still processing the uploaded media.
video formatVideo is not in MP4 with H.264/AAC.
video codecVideo uses an unsupported codec (e.g. HEVC/H.265).
duration exceedVideo exceeds the 5-minute Threads cap.

Other platforms

Instagram errors

33 documented

X (Twitter) errors

12 documented

TikTok errors

25 documented

Facebook errors

15 documented

LinkedIn errors

9 documented

Bluesky errors

10 documented

Pinterest errors

8 documented

YouTube errors

15 documented

Ready to Add Social Media to Your Product?

One API. Every platform. Start building with free credits.

Start Posting for FreeNo credit card required.
POST https://api.postpeer.dev/v1/posts
{ "platforms": ["twitter", "linkedin", "instagram], "content": "Hello world!" }
Published
5 platforms
TwitterLinkedInFacebook+2
All posts delivered
Scheduled
queue
12
Queued
847
Sent
Next: in 15 min
Platforms
connected
XIGFBLITT
One API, every platform