Posting photos to a Facebook Page: single and multi-photo posts
A photo reaches a Facebook Page through POST /{page-id}/photos, with url set to an image already online or the file attached as multipart form data, and caption as its text. Several photos make one post when each is uploaded with published set to false and their IDs go to POST /{page-id}/feed in attached_media, as media_fbid entries.
easyCoexistence posts a photo to a Facebook Page with publish_facebook_post from Claude, ChatGPT or your own code, now or scheduled up to 90 days ahead, one photo per post; a multi-photo post is made on Facebook or in Meta Business Suite.
Largest photo file the photos edge accepts; Meta suggests keeping PNG files under 1 MB to avoid pixelation.
How long unpublished photos stay on Meta's servers; those not published in that time are deleted.
Error code on the photos edge for a missing or invalid image file.
Parameter for photos in a scheduled post: published must be false, and the photo itself takes no scheduled_publish_time.
Returned beside the photo's id when a photo is published: the ID of the Page post that carries it.
How do you post one photo to a Page?
Send POST /{page-id}/photos with url set to a photo already on the internet, or attach the file as multipart/form-data, where the field has historically been called source. caption is the photo's text and supports emoji. Meta answers with two IDs: id, the photo, and post_id, the Page post that carries it.
POST /{page-id}/photos
{
"url": "https://example.com/flyer.jpg",
"caption": "Doors open at 9 on Saturday."
}
200 OK
{
"id": "<PHOTO_ID>",
"post_id": "<PAGE_POST_ID>"
}Which photo parameters does Meta document?
Beyond url and caption, the photos reference lists options that shape how a photo goes out:
- published: true by default; false uploads the photo without publishing it.
no_story: true suppresses the feed story Meta generates when an app uploads a photo.alt_text_custom: an accessible alternative description of the image.scheduled_publish_time: when an unpublished photo post should go live, on Pages only.- place: the ID of a Page for the location;
backdated_timesets an earlier creation time. - message: marked deprecated, with caption named in its place.
Which image files does Meta accept?
JPEG, BMP, PNG, GIF and TIFF, up to 10 MB a file. Meta recommends keeping PNG files under 1 MB, since larger ones may look pixelated. Before publishing, Facebook strips location metadata from the image and resizes it to several dimensions for rendering, and a missing or unreadable file fails with error 324.
How do you publish several photos in one post?
In two steps. Upload each photo to POST /{page-id}/photos with published set to false, which returns its ID without posting anything. Then send POST /{page-id}/feed with the message and attached_media, one media_fbid per photo, and Meta returns the ID of a single post that shows the photos together. Unpublished photos stay on Meta's servers for about 24 hours, so make the feed call within that time.
How is a multi-photo post scheduled?
With Meta's own scheduling. Upload the photos with published set to false and temporary set to true, then send the feed call with published false, scheduled_publish_time and unpublished_content_type set to SCHEDULED. Meta's Pages guide sets the publish time between 10 minutes and 30 days after the request, and Meta holds the post until then.
What does publish_facebook_post take for a photo?
account_id, image_url, a public HTTPS link to one image, and message, the post's text. A post holds one image, and a link passed with it is refused, so a URL belongs in the message. Without scheduled_at the photo goes out at once; with it, from 1 minute to 90 days ahead in ISO 8601 with a timezone, easyCoexistence copies the image when the post is scheduled and publishes it then. Facebook's 10 MB limit for a photo still applies, although the copy step accepts images up to 30 MB.
How do you post several photos through easyCoexistence?
You cannot yet. publish_facebook_post takes one image_url, and easyCoexistence has no tool for the two-step call Meta documents: one POST to <PAGE_ID>/photos per image, with url and published set to false, then the returned IDs posted together to <PAGE_ID>/feed. Post the album on Facebook or in Meta Business Suite, or publish the photos as separate posts.
Common mistakes
- Posting several photos one call at a time. With published left at true, each call to /photos makes its own post; upload them unpublished and attach them to one feed post.
- Waiting more than a day to attach unpublished photos. Meta keeps them for about 24 hours, then deletes them.
- Leaving temporary off a photo for a scheduled post. Meta requires temporary set to true, with published false, on photos attached to a scheduled post.
- Editing the photo's id instead of the post. The photos edge returns id for the photo and post_id for the post; changes to the text go to the post_id.
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 Facebook photo post have alt text?
Yes. alt_text_custom on /{page-id}/photos sets an accessible description of the image. publish_facebook_post does not take it, so add the description on Facebook after the photo is posted.
Does Facebook keep a photo's location data?
No. Meta strips location metadata before publishing; to show a place, set place to the ID of a Page with that location.
Can a single photo post be scheduled?
Yes. publish_facebook_post with scheduled_at holds it in easyCoexistence's queue, 1 minute to 90 days ahead. On Meta's side, published false with scheduled_publish_time schedules it too.
How much does easyCoexistence cost for a Facebook Page?
Each Page you connect is one connection, at US$ 9 to US$ 0.75 per connection per month depending on how many you have, and the first 3 days are free.
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