API guide

The Facebook API in 2026.Pages only. Profiles and Groups are closed.

Posting to Facebook goes through the Pages API, part of the Graph API. It has no fee and posts to Pages, never to personal profiles or Groups. You need pages_manage_posts, a Page access token and, to serve Pages you don't manage, App Review. A photo is one call; several photos are one upload each, then a feed post that attaches them.

Checked October 6, 2026. Breakreach is our product.

# 1-2. Upload each photo unpublished, with the Page tokencurl -X POST "https://graph.facebook.com/v25.0/$PAGE_ID/photos" \  -d "url=https://cdn.northbeam.coffee/launch.jpg" \  -d "published=false" \  -d "access_token=$PAGE_TOKEN"curl -X POST "https://graph.facebook.com/v25.0/$PAGE_ID/photos" \  -d "url=https://cdn.northbeam.coffee/latte.jpg" \  -d "published=false" \  -d "access_token=$PAGE_TOKEN" # 3. One Page post with both photos attachedcurl -X POST "https://graph.facebook.com/v25.0/$PAGE_ID/feed" \  -d "message=Meet Morning Light, our new blend." \  -d 'attached_media[0]={"media_fbid":"'$PHOTO_1'"}' \  -d 'attached_media[1]={"media_fbid":"'$PHOTO_2'"}' \  -d "access_token=$PAGE_TOKEN"

1/3 POST /{page-id}/photos (photo 1)Sending

Published · now

Northbeam Coffee

Just now ·

Meet Morning Light, our new blend. Honey, orange and cocoa notes, out tomorrow.

Like Comment Share

The Facebook API at a glanceWhat it takes before the first post.

Price: No fee. Meta's Platform Terms say it doesn't guarantee the platform will always be free
Where you can post: Facebook Pages. Personal profiles (since 2018) and Groups (since April 22, 2024) are closed to apps
Permission: pages_manage_posts, with pages_read_engagement and pages_show_list, on a Page access token
Review: App Review before anyone without a role on your app can use it; Business Verification for Advanced Access. Meta says about a week
Access tokens: User tokens last about 60 days. A Page token taken from a long-lived user token doesn't expire
Scheduling: Yes: published=false and scheduled_publish_time, 10 minutes to 30 days ahead
Rate limit: 4,800 calls times the Page's engaged users per 24 hours. Reels: 30 a day
Version: Graph API v26.0 since July 29, 2026

Checked on October 6, 2026, from Facebook's developer documentation and terms.

Our recommendation

To post to Facebook from your product, use Breakreach's API.We built it, so here's the case.

See the request

No App Review, Business Verification or Page tokens to manage: Pages connect through Breakreach's Meta app, approved by Meta
Up to 10 photos or a video in one request: the unpublished uploads and attached_media are handled
Comments and Messenger replies through the same API, and the same request posts to Instagram, Threads and the rest

When to use Facebook's API directly. Breakreach posts feed posts only: no Reels, no Stories, no first comment, and no photos and video in the same post. Meta's API does Reels, Stories and comments, so build on it if you need them.

How to get access to the Facebook APIFrom a developer account to your first real post.

1Create an app with the Pages use case"Manage everything on your Page". business_management, pages_show_list and public_profile come by default; add pages_manage_posts and pages_read_engagement.
2Set up Facebook Login for BusinessThe redirect URI, the deauthorize and data deletion URLs, and a configuration for user or system-user tokens.
3Get a Page access tokenExchange the user's token for a long-lived one (about 60 days), then call GET /{user-id}/accounts: the Page tokens it returns don't expire.
4Test with people who have a role on the appIn Development mode the app can ask them for any permission. Every Page permission needs App Review before the app goes live for anyone else.
5Pass App Review, and Business VerificationA screen recording per permission, 1080p or better, and a successful call with each one in the last 30 days. Advanced Access also needs Business Verification.

Meta says a submission usually gets a decision within a week, often in 2 to 3 days. You can try the calls without code in the Graph API Explorer: pick the Page token from /me/accounts and POST to /{page-id}/feed.

How to post with the Facebook APIThe requests in the demo above, one by one.

1Upload each photo, unpublishedPOST /{page-id}/photos with url and published=false returns a photo id. Unpublished photos wait about 24 hours.
2Create the postPOST /{page-id}/feed with message and attached_media[i]={"media_fbid": id}, form-encoded. The answer is the post id, {page-id}_{post-id}.

A text or link post is one call to /feed. A single photo is one call to /photos with a caption, since the photos endpoint marks message as deprecated. A video goes to /videos with file_url, Reels to /video_reels in three phases, Stories to /photo_stories and /video_stories. To schedule, add published=false and scheduled_publish_time.

Common Facebook API errorsWhat they mean and how to fix them.

Error	What it means	Fix
`190`	The access token expired, the user changed their password, or the token is invalid.	Get a new token through Facebook Login.
`190 / 2069032`	A Page access token is required for this call.	Use the Page token from /me/accounts.
`200 / 10`	The permission wasn't granted, or was removed.	Ask for pages_manage_posts again.
`1 / 2853006`	The user doesn't have the create-content task on the Page.	A Page admin grants it.
`368`	Temporarily blocked for policy violations.	Wait, then retry.
`506`	Duplicate post: the same content twice in a row.	Change the content.
`32 / 80001`	The Page's rate limit.	Back off; X-Business-Use-Case-Usage says when calls work again.

Facebook API limitsRate limits, text and media.

API calls4,800 calls times the Page's engaged users per 24 hours, with a Page token. Meta documents no daily cap on feed posts.
PhotosJPEG, BMP, PNG, GIF or TIFF, up to 10 MB. Unpublished uploads stay available about 24 hours.
Reels30 API-published Reels per 24 hours, 3 to 90 seconds, 9:16.
StoriesVideo Stories up to 60 seconds, and a photo or video can't be one already posted.
Scheduling window10 minutes to 30 days ahead in the Posts guide. Meta's reference pages say 75 days for feed posts, 29 days for Reels and 6 months for videos.

Is the Facebook API free?

There's no fee and no price list in the Pages API docs. Meta's Platform Terms only say it doesn't guarantee the platform will always be free.

What costs is the review and the tokens. And only Pages: no app can post to a personal profile since Meta deprecated publish_actions in 2018, or to a Group since it removed the Groups API on April 22, 2024.

Through Breakreach, a Facebook Page counts like any other connected account: the first 2 are free, then $5 a month each up to 20.

Ways to post to Facebook from code

	What you set up	Price	Posts to Facebook
Breakreach	An API key. Accounts connect through Breakreach's reviewed apps, or your users connect theirs on a hosted page	First 2 accounts free, then $5 a month per account (less from 21)	Yes, Pages
Facebook's own API	A Meta app, App Review and Business Verification	No, Fee	Yes
Upload-Post	An API key	Free for 2 profiles and 10 uploads a month; Basic $24 a month for 5 profiles	Yes
Zernio	An API key	First 2 accounts free, then $6 per account up to 10, $3 up to 100, $1 after	Yes
Ayrshare	An API key	From $149 a month for 1 profile, no free plan	Yes
Outstand	An API key	$19 a month for 3,000 posts, then per post	Yes

Checked on October 6, 2026, from Facebook's developer documentation and each company's pricing page. Breakreach is our product.

What the Facebook API can't do

Post to personal profiles: publish_actions was deprecated in 2018
Post to Groups: the Groups API was removed on April 22, 2024
Edit a Page post your app didn't create
Run ads: those go through the Marketing API

Post to Facebook with Breakreach's APIOne request, scheduled, with retries.

POST /v1/posts

curl https://api.breakreach.com/v1/posts \  -H "Authorization: Bearer $BREAKREACH_API_KEY" \  -H "Content-Type: application/json" \  -d '{    "content": "Meet Morning Light, our new blend. Honey, orange and cocoa notes, out tomorrow.",    "accountIds": ["6701a2f4c9e84b0012a3b4ca"],    "media": ["https://cdn.northbeam.coffee/launch.jpg", "https://cdn.northbeam.coffee/latte.jpg"],    "scheduledAt": "2026-10-07T09:00:00"  }'

What it posts on Facebook

Text, photos or a videoText alone, up to 10 photos laid out as a grid, or one video with the text as its description.
Pages you manageEach Page connects once through Facebook's sign-in, and its token is kept for you.
Comments and MessengerRead, answer, hide or delete comments, and answer Messenger within Facebook's 24-hour window.
StatsReactions, comments, shares and views per post, and daily Page insights.

Not yet

Reels and Stories
Photos and a video in the same post
First comments

The full reference, webhooks and the price per connected account are on the developers page, and the OpenAPI spec is at api.breakreach.com/v1/openapi.json.

FAQ

Questions, answered.

Short answers about the Facebook API.

There's no fee for the Pages API, and no price list. Meta's Platform Terms only say it doesn't guarantee the platform will always be free. The cost is App Review and token upkeep.

No. Meta deprecated publish_actions in 2018, and the user feed endpoint doesn't accept new posts. Apps post to Pages.

No. Meta removed the Groups API and publish_to_groups for every version on April 22, 2024.

A Page token taken from a long-lived user token has no expiration date. It's invalidated if the user changes their password, loses their role on the Page or removes the app.

Upload each photo to /{page-id}/photos with published=false, then create one post on /{page-id}/feed with attached_media[0], attached_media[1] and so on, each holding a media_fbid.

Yes: published=false and scheduled_publish_time, a Unix time between 10 minutes and 30 days ahead per the Posts guide.

The first 2 connected accounts are free; from the third it's $5 a month per account up to 20, $3 up to 100, then $2. You pay per connected account, never per post or per request.