How to Schedule Threads Posts via API
Publish text posts, images, and videos to Threads using the PostFast API. Schedule content programmatically with full media support.
Threads is Meta's text-based conversation app that competes with X (Twitter). Using the PostFast API, you can schedule posts to Threads including text-only posts, single images or videos, and carousels with multiple images.
Threads posts support up to 500 characters of text, and you can attach up to 10 images or a single video. The platform integrates with Instagram, so your Threads account is linked to your Instagram profile.
Key capabilities when scheduling Threads posts via API include text posts (up to 500 characters), image posts (single or carousel up to 10 images), video posts (single video), and cross-posting to Instagram if desired.
Code Example
const response = await fetch('https://api.postfa.st/social-posts', {
method: 'POST',
headers: {
'pf-api-key': 'YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
"posts": [
{
"content": "Just shipped a new feature! Building in public is the way. 🚀\n\nWhat are you working on today?",
"mediaItems": [
{
"key": "image/a1b2c3d4-e5f6-7890-1234-567890abcdef.jpg",
"type": "IMAGE",
"sortOrder": 0
}
],
"scheduledAt": "2025-01-31T10:00:00.000Z",
"socialMediaId": "990i2833-j6df-75h8-e150-889099883005"
}
],
"controls": {}
})
});
const data = await response.json();
Did You Know?
Tips
Keep posts concise - Threads users expect quick, conversational content
Use line breaks to improve readability for longer posts
Include a question to encourage replies and boost engagement
Schedule during peak hours (typically 9 AM - 12 PM and 7 PM - 9 PM)
Schedule to Threads, Instagram, and more from one API
Common Pitfalls
You cannot combine images and videos in a single Threads post. Choose one media type per post.
URLs count toward your 500 character limit. Long URLs can consume significant space.
Unlike X, Threads does not support editing posts after publishing. Double-check content before scheduling.
Frequently Asked Questions
What media types does Threads support?
Threads supports images (JPEG, PNG) and videos (MP4). You can post up to 10 images in a carousel, or a single video per post. Images and videos cannot be mixed in one post.
Can I cross-post to Instagram and Threads simultaneously?
Yes, you can schedule separate posts to both platforms using the same API call by including multiple posts with different socialMediaId values.
Does Threads support hashtags?
Yes, hashtags work on Threads but are less prominent than on Instagram. They help with discoverability but don't have dedicated hashtag pages like Instagram.