How to Schedule Facebook Posts via API
Publish feed posts to Facebook Pages using the PostFast API. Schedule text, images, videos, and multi-image carousels programmatically.
Facebook Posts are permanent feed content that appears on your Page timeline and in followers' news feeds. Using the PostFast API, you can schedule Posts by setting facebookContentType to "POST" (or omitting it since POST is the default).
Posts support rich media including up to 10 photos in a carousel format, or a single video. Note that you cannot mix photos and videos in the same post.
Key capabilities when scheduling Facebook Posts via API include multi-image carousels (up to 10 photos), video posts (single video per post), text-only posts, and permanent timeline content.
API Parameters
| Parameter | Type | Description |
|---|---|---|
facebookContentType | string | Type of Facebook content to create POSTREELSTORY |
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": "Hello from the API! Check out these amazing photos from our latest event.",
"mediaItems": [
{
"key": "image/b1c2d3e4-f5a6-7890-1234-567890abcdef.jpg",
"type": "IMAGE",
"sortOrder": 0
},
{
"key": "image/c2d3e4f5-a6b7-8901-2345-67890abcdef1.jpg",
"type": "IMAGE",
"sortOrder": 1
}
],
"scheduledAt": "2025-01-31T10:00:00.000Z",
"socialMediaId": "660f9500-f3ac-42e5-b827-556766550002"
}
],
"controls": {
"facebookContentType": "POST"
}
})
});
const data = await response.json();
Did You Know?
Tips
facebookContentType: "POST" is the default, so you can omit it if posting regular feed content
Use sortOrder to control the order of images in multi-image posts
Posts without media (text-only) are supported but typically get less reach
For video content that you want in the Reels algorithm, use facebookContentType: "REEL" instead
Schedule Posts, Reels, and Stories to Facebook via API
Common Pitfalls
You cannot combine images and videos in a single Facebook Post. Choose one media type per post.
Video Posts appear in the feed but do not get Reels algorithm distribution. For short-form video reach, use facebookContentType: "REEL".
More than 10 images will cause an error. If you have more, split into multiple posts.
Frequently Asked Questions
What is the difference between POST and REEL for videos?
POST uploads video to your timeline as a traditional video post. REEL publishes to the Reels tab with full algorithm distribution and typically gets 2-5x more reach.
Can I schedule text-only posts?
Yes, simply omit the mediaItems array or pass an empty array. The post will contain only the text content.
How do carousels display on Facebook?
Multiple images are displayed as a swipeable carousel on mobile and a grid/gallery on desktop. Use sortOrder to control the display order.