Error Reference
Threads API Error Reference
Comprehensive reference for Threads API errors. Find solutions and troubleshoot common integration issues.
7 error codes3 categoriesGraph API
Error Categories
All Error Codes
#Authentication
revoked_access_tokenrefresh-tokenThreads access token is invalid or revoked. Please reconnect your Threads account.
Solution:
Your Threads access token was revoked. This happens when you remove app permissions or Instagram security detects suspicious activity. Reconnect your account.
token is invalidrefresh-tokenThreads access token is invalid or revoked. Please reconnect your Threads account.
Solution:
Your token is no longer valid. Threads tokens are tied to Instagram accounts. Reconnect your Threads account through Instagram business account.
session has been invalidatedrefresh-tokenYour Threads session has expired. Please reconnect your Threads account.
Solution:
Your Threads session expired. This can happen after password changes or security checks. Reconnect your Threads account to establish a new session.
#Media
media processingretryThreads is still processing your media. Retrying...
Solution:
Threads is still processing your uploaded media. This is normal and the system will automatically retry. Large videos may take longer to process.
#Video
video formatuser-errorVideo format not supported. Please ensure video is H.264/AAC MP4 format.
Solution:
Threads requires MP4 videos with H.264 codec and AAC audio. Convert your video to this format using tools like FFmpeg or HandBrake.
video codecuser-errorVideo format not supported. Please ensure video is H.264/AAC MP4 format.
Solution:
Video codec not supported. Use H.264 (video) and AAC (audio) codecs. Avoid using HEVC/H.265 or other modern codecs that Threads doesn't support yet.
duration exceeduser-errorVideo duration exceeds Threads' limit (5 minutes max).
Solution:
Threads videos must be 5 minutes or less. Trim your video to fit within this limit. Consider splitting longer content into multiple posts.
Best Practices
Error Handling
- Handle media processing delays automatically
- Validate video format before upload
- Monitor token expiration
- Implement retry logic for media processing
Prevention Tips
- Use H.264/AAC MP4 format for videos
- Keep videos under 5 minutes
- Reconnect account after Instagram password changes
- Wait for media processing to complete
Need Help with Threads Integration?
Our API handles error scenarios automatically with smart retry logic and detailed logging.