How to Schedule Facebook Stories via API
Publish 24-hour temporary content as Facebook Stories using the PostFast API. Schedule images or videos that disappear after 24 hours.
Facebook Stories are temporary posts that disappear after 24 hours, appearing at the top of the Facebook app. Using the PostFast API, you can schedule Stories by setting facebookContentType to "STORY".
Stories are full-screen vertical content optimized for mobile viewing. They appear prominently in the Stories tray and can include either a single image or a single video.
Key characteristics of Facebook Stories via API include 24-hour visibility (content auto-deletes), full-screen vertical format (9:16 aspect ratio recommended), single media only (1 image or 1 video per Story), and high visibility in the Stories tray.
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": "Quick story update! Behind the scenes today.",
"mediaItems": [
{
"key": "image/e4f5a6b7-c8d9-0123-4567-890abcdef123.jpg",
"type": "IMAGE",
"sortOrder": 0
}
],
"scheduledAt": "2025-01-31T10:00:00.000Z",
"socialMediaId": "660f9500-f3ac-42e5-b827-556766550002"
}
],
"controls": {
"facebookContentType": "STORY"
}
})
});
const data = await response.json();
Did You Know?
Tips
Use vertical 9:16 media for the best full-screen experience
Schedule Stories during peak hours for maximum views before they expire
Stories are great for time-sensitive content like flash sales or daily updates
Add text overlays to your media before uploading since the API does not support text additions
Schedule Stories to Facebook and Instagram from one API
Common Pitfalls
Stories only accept 1 media item. If you include multiple items in mediaItems, only the first will be used or the request may fail.
Non-vertical media will be cropped or displayed with black bars, reducing the visual impact of your Story.
Stories are temporary by design. If you need permanent content, use facebookContentType: "POST" or "REEL" instead.
Frequently Asked Questions
Can I schedule multiple Stories at once?
Yes, include multiple posts in your API request, each with facebookContentType: "STORY". Each will be a separate Story in your Stories tray.
Do Facebook Stories support carousels?
No, each Story is a single image or video. To create a carousel-like experience, schedule multiple Stories with the same scheduledAt time.
Can I add stickers or text via the API?
No, the API does not support adding stickers, text, or interactive elements. Add these to your media file before uploading.