How to Schedule Threads Carousels via API
Create multi-image carousel posts on Threads using the PostFast API. Schedule up to 10 images in a single swipeable post.
Threads carousels let you share multiple images in a single swipeable post, perfect for tutorials, product showcases, or storytelling. Using the PostFast API, you can schedule carousel posts with 2-10 images.
To create a carousel, include multiple IMAGE items in your mediaItems array with sequential sortOrder values. Threads will automatically display them as a swipeable carousel.
Unlike single-image posts, carousels encourage users to spend more time engaging with your content, often resulting in higher engagement rates and better reach on the platform.
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": "5 design principles every developer should know (swipe through)\n\n1. Whitespace is your friend\n2. Limit your color palette\n3. Typography matters more than you think\n4. Consistency builds trust\n5. Less is almost always more\n\nWhich one do you struggle with most?",
"mediaItems": [
{
"key": "image/t1h2r3e4-a5d6-7890-1234-567890abcdef.jpg",
"type": "IMAGE",
"sortOrder": 0
},
{
"key": "image/t2h3r4e5-b6c7-8901-2345-67890abcdef1.jpg",
"type": "IMAGE",
"sortOrder": 1
},
{
"key": "image/t3h4r5e6-c7d8-9012-3456-7890abcdef12.jpg",
"type": "IMAGE",
"sortOrder": 2
},
{
"key": "image/t4h5r6e7-d8e9-0123-4567-890abcdef123.jpg",
"type": "IMAGE",
"sortOrder": 3
},
{
"key": "image/t5h6r7e8-e9f0-1234-5678-90abcdef1234.jpg",
"type": "IMAGE",
"sortOrder": 4
}
],
"scheduledAt": "2025-01-31T10:00:00.000Z",
"socialMediaId": "990i2833-j6df-75h8-e150-889099883005"
}
],
"controls": {}
})
});
const data = await response.json();
Did You Know?
Tips
Use the first image as a hook - it's what users see before swiping
Number your slides in the caption to encourage swiping (e.g., 'Swipe for all 5 tips')
Keep a consistent visual style across all carousel images for a professional look
End with a call-to-action slide to drive engagement or follows
Carousels perform well for educational content, tutorials, and listicles
Schedule carousels to Threads and 7 other platforms from one API
Common Pitfalls
If you only include 1 image, it will be a regular image post, not a carousel. Include at least 2 images.
Ensure sortOrder values are sequential starting from 0. Gaps or duplicates may cause unexpected image ordering.
You cannot include videos in a Threads carousel. All media items must be IMAGE type.
While Threads accepts various sizes, using consistent dimensions across all carousel images provides a better viewing experience.
Frequently Asked Questions
What's the maximum number of images in a Threads carousel?
Threads carousels support 2-10 images. You need at least 2 images for it to be treated as a carousel (1 image = regular post).
Can I mix images and videos in a Threads carousel?
No, Threads carousels only support images. If you need to post a video, it must be a separate single-video post.
How do I control the order of images in the carousel?
Use the sortOrder field in each mediaItem. Set values starting from 0 in the order you want images to appear (0 = first, 1 = second, etc.).