Log inStart Free Trial
easyCoexistence Official APIs

Facebook Page Stories through the API

Meta's Stories API publishes photo and video Stories to a Facebook Page. A photo story takes a photo uploaded with published set to false, then POST /{page-id}/photo_stories with its photo_id; a video story goes through start, upload and finish calls on /{page-id}/video_stories. Video stories run up to 60 seconds, and photos up to 10 MB.

easyCoexistence publishes a Facebook Page's posts with publish_facebook_post from Claude, ChatGPT or your own code: text, links, photos and videos.

60 seconds

Longest video story Meta allows on a Facebook Page.

10 MB

Largest photo file for a photo story, in JPEG, BMP, PNG, GIF or TIFF.

9 x 16

Video story aspect ratio, with 1080 x 1920 pixels recommended and 540 x 960 at least.

PUBLISHED, ARCHIVED

Statuses GET /{page-id}/stories reports; archived stories appear only with the Page's story archive turned on.

How is a photo story published?

In two calls. Upload the photo to POST /{page-id}/photos with published set to false, which returns the photo's ID, then send POST /{page-id}/photo_stories with photo_id set to it. Meta answers with success set to true and post_id, the ID of the story post.

Publishing a photo story
POST /{page-id}/photo_stories
{
  "photo_id": "<PHOTO_ID>"
}

200 OK
{
  "success": true,
  "post_id": "<STORY_POST_ID>"
}

How is a video story published?

In three steps, the same shape as a Reel. POST /{page-id}/video_stories with upload_phase set to start returns a video_id and an upload_url on rupload.facebook.com. The video goes there, as the file's bytes with offset and file_size headers or as a file_url header for a hosted file. Then POST /{page-id}/video_stories with the video_id and upload_phase set to finish publishes it and returns post_id.

1StartPOST /{page-id}/video_stories, upload_phase start
2UploadThe bytes or a file_url, sent to the upload_url
3StatusGET /{video-id}?fields=status
4Finishupload_phase finish with video_id: returns post_id

What media can a story use?

Meta's Stories guide gives a photo specification and a video one. Photos are .jpeg, .bmp, .png, .gif or .tiff files of up to 10 MB, with PNG best kept under 1 MB. Videos follow the Reels specification, with a shorter ceiling:

  • File: .mp4 recommended, at a 9 x 16 aspect ratio.
  • Resolution: 1080 x 1920 pixels recommended, 540 x 960 at least.
  • Frame rate: 24 to 60 frames per second, fixed, with progressive scan.
  • Length: 60 seconds at most for a video story.
  • Codecs: H.264 or H.265, with VP9 and AV1 also supported; audio in AAC Low Complexity at 48 kHz, stereo, 128 kbps or more.

Which media cannot be used for a story?

A photo or video already used in a previously published post: Meta's rule is that media uploaded for a story cannot have been. A hosted video also has to be reachable, since Meta rejects files on sites whose robots.txt blocks the facebookexternalhit/1.1 user agent, and files on its own CDN, such as fbcdn URLs.

How do you list a Page's stories?

GET /{page-id}/stories returns one object per story, and the list can be filtered by status or by date with since and until. Each object holds:

  • post_id: the ID of the story post.
  • status: PUBLISHED or ARCHIVED; archived stories need the Page's story archive turned on.
  • creation_time: the UNIX timestamp when the story was published.
  • media_type and media_id: photo or video, and the ID of that media.
  • url: the story's Facebook address, under facebook.com/stories/.

Which permissions does it need?

A Page token from someone who can perform the CREATE_CONTENT task on the Page, through Facebook Login or Facebook Login for Business, with pages_manage_posts, pages_read_engagement and pages_show_list granted. Requests made as a business system user also need business_management. They are the same three permissions that publishing to the Page's feed asks for.

When does a story go up?

When the photo_stories call or the video_stories finish call is made. Meta's Stories API takes no publish time: photo_stories takes a photo_id, and the finish call takes video_id, upload_phase and the optional is_ai_generated flag. A story for later needs a call made at that moment, from a scheduler of your own.

How do you publish a story through easyCoexistence?

You cannot yet. publish_facebook_post publishes posts rather than stories, and easyCoexistence has no tool for photo_stories or video_stories; Page tokens are not handed out, so the calls cannot run from your own code on its connection either. Publish stories from Facebook or Meta Business Suite.

Common mistakes

  • Reusing a photo from an earlier post. Media for a story cannot come from a previously published post, so upload it again with published set to false.
  • Turning a 90-second Reel into a story. Reels may run to 90 seconds, but a video story stops at 60.
  • Expecting archived stories in the list. They appear in GET /{page-id}/stories only when the Page's story archive is turned on.
  • Sending the video to graph.facebook.com. The upload belongs at the upload_url on rupload.facebook.com; the start, finish and status calls stay on graph.facebook.com.
Doing this with EasyCoexistence

It has no tool for the Stories API, so stories are published from Facebook or Meta Business Suite. US$ 9 to US$ 0.75 per connection per month, falling as you add connections, with the first 3 days free.

easyCoexistence is a multichannel API and MCP server that connects AI agents such as Claude and ChatGPT to WhatsApp, Instagram, TikTok, Facebook and more. On WhatsApp it uses Coexistence: the business keeps using its number in the WhatsApp Business app while the AI works through Meta's official API.

Frequently asked questions

Can a Reel be shared as a Facebook Page story?

Yes, if it runs 60 seconds or less: Meta's specification says a Reel published as a story on a Page cannot exceed that.

Can a video story be labelled as made with AI?

Yes. Set is_ai_generated to true in the finish call on video_stories; it defaults to false.

What if a story's video upload is interrupted?

Send the upload again with offset set to 0 to restart, or with offset set to the bytes_transfered value from a status check to resume.

How much does easyCoexistence cost for a Facebook Page?

US$ 9 to US$ 0.75 per connection per month, with the first 3 days free. Each Page is one connection, and the price per connection falls as you add more.

Keep reading

Connect your first channel in two minutes.

No platform reviews to wait for. Connect WhatsApp, Instagram, TikTok or another channel, then ask your AI to post, reply or report, and watch it work.

  • 3 days free
  • Cancel any time
  • Official APIs only
  • Monitored 24/7

Verified on