Facebook API for developersThe Facebook Pages API,without the Meta work
Publish posts, photos, links, Stories and Reels to your Page. Answer Messenger and comments, and read insights. One API key, on OmniSocials’ approved Meta app.
Webhooksyour-app.com/hooks
post.scheduledpost 1024just now200
post.publishedpost 10192 h ago200
post.approvedpost 10193 h ago200
POST/v1/posts/createapplication/json
01{
02 "type": "reel",
03 "content": "Post from your own code: SDKs in 8 languages.",
04 "accounts": ["facebook"],
05 "media_urls": ["https://cdn.example.com/sdks.mp4"],
06 "schedule_at": "2026-10-22T18:00:00Z",
07 "facebook": {
08 "first_comment": "Which SDK do you use?",
09 "thumbnail_type": "from-video",
10 "thumb_offset": 3000
11 }
12}
Sending201 Created412 ms
Send13{
14 "data": {
15 "id": "1024",
16 "status": "scheduled",
17 "app_url": "https://app.omnisocials.com/create-post/1024"
18 }
19}
A request creates a Facebook Reel for Thu at 18:00; it appears in the OmniSocials calendar and the webhook post.scheduled fires.
Your coding agent runs the same calls through the CLI
Skip the Meta app review
Facebook's own API needs a Meta app, nine permissions through App Review, Page tokens and a three-step video upload. OmniSocials already did that work.
On your own
pages_show_listpages_read_engagementpages_manage_posts
pages_manage_metadatapages_manage_engagementpages_messaging
read_insightspublish_videobusiness_management
Meta appApp reviewVerificationHostingPage tokensUploadsPollingRetriesFirst postOn OmniSocials
Sign inAPI keyPOSTFirst postAll 9 permissions already approvedEvery format, one request
Posts with photos or a video, link posts, Stories and Reels share one request shape. Set the type, add media URLs or a link and a time. OmniSocials checks the media against Facebook’s rules before it uploads.
Post from your own code: SDKs in 8 languages.
Thumbnail
Move the slider to select which frame from the video to use as thumbnail
OmniSocialsFollowPost from your own code: SDKs in 8 languages.
POST/v1/posts/create
01{
02 "type": "reel",
03 "content": "Post from your own code: SDKs in 8 languages.",
04 "accounts": ["facebook"],
05 "media_urls": ["https://cdn.example.com/sdks.mp4"],
06 "schedule_at": "2026-10-22T18:00:00Z",
07 "facebook": {
08 "first_comment": "Which SDK do you use?",
09 "thumbnail_type": "from-video",
10 "thumb_offset": 3000
11 }
12}
201 Createdstatus: "scheduled"
Posts and photos
Text with one photo, several photos or one video, and a first comment right after the post goes live.
media_urlsfacebook.first_comment
Link posts
Send a link without media. Facebook builds the preview card from the linked page’s own tags.
link_url
Stories and Reels
Stories go out slide by slide, up to 10, without a caption. Reels take a frame or an image as the thumbnail.
type: "story"type: "reel"thumbnail_type
Connect a Page once, post from code
Sign in with Facebook once inside OmniSocials and pick the Page. Create an API key, and your code posts, replies and reports for that Page.
OmniSocials
Name, icon, social channels and who can open this workspace.
GeneralMembersClientsApproval workflowsAPI
Workspace iconJPG or PNG, up to 2 MB.
Workspace nameOmniSocials
Social channels
The accounts this workspace posts to.
Connected
@omnisocials_
InstagramConnect Facebook for mentions
@omnisocials_
Threads
OmniSocials
LinkedIn Page
@omnisocials_
X
Add a channel
FacebookPosts, Stories & ReelsLinkedIn ProfilePosts & Carousels
YouTubeShorts
TikTokVideos & Photo posts
PinterestPins & Carousels
BlueskyPosts & Threads
MastodonAny server
Google BusinessUpdates, Events & Offers
TelegramChannels and groupsComing soon
Danger zone
Delete workspace
Deletes this workspace with its posts, media and settings for good. This cannot be undone.
OmniSocials
Name, icon, social channels and who can open this workspace.
GeneralMembersClientsApproval workflowsAPI
API keys
Keys that can only reach this workspace.
| Name | Key | Last used | |
|---|---|---|---|
Claude | omsk_live_••••7c2e | Oct 20, 2026 |
GET/v1/accounts?platform=facebook
200 OK88 ms
01{
02 "data": [
03 {
04 "id": "4127_facebook",
05 "platform": "facebook",
06 "display_name": "OmniSocials",
07 "content_types": ["post", "story", "reel"],
08 "status": "active"
09 }
10 ],
11 "workspace_name": "OmniSocials"
12}
Authorization: Bearer $OMNISOCIALS_API_KEY
Facebook Login
Sign in with Facebook once and pick the Page. Pages you manage; personal profiles and Groups can’t connect.
A key per workspace
A key only reaches its own workspace. Inbox access is switched on per key.
What the Page can post
The accounts call lists the connected Page with the formats it takes.
GET /v1/accountscontent_types
Answer Messenger and comments
List the Page’s Messenger conversations, comments and mentions, then reply, hide or delete from your own code. The API checks Meta’s 24-hour window before it sends a DM.
Social Inbox
AllUnread4CommentsDMs
Daan Lindqvist2mWe want to post them from our own CMS.
Best times to post, worked out from your own posts. Here is how it works.14mHana and 2 others: Does this work for several Pages?2 newOmniSocials saved us the whole Meta app review1h
Ravi: Mentioned your Page: "OmniSocials saved us the whole Meta app review"1 new
The Social Inbox has an API now. Four new endpoints for comments, DMs and mentions.3hSara: Is the inbox API on every plan?
Leo Vik5hCan I send a PDF in a reply?Daan LindqvistFacebook DMView profileDaan LindqvistDaan Lindqvist · Facebook09:12
Hi! Can the API post Reels to our Facebook Page?
We want to post them from our own CMS.
Type a message...
GET/v1/inbox/conversations?platform=facebook&type=dm
200 OK104 ms
01{
02 "data": [
03 {
04 "conversation_id": "8812",
05 "platform": "facebook",
06 "type": "dm",
07 "participant": {
08 "name": "Daan Lindqvist"
09 },
10 "unread_count": 2,
11 "last_message": {
12 "direction": "incoming",
13 "text": "We want to post them from our own CMS."
14 }
15 }
16 ]
17}
Authorization: Bearer $OMNISOCIALS_API_KEY
Comments
Reply under the comment, hide it or delete it. Each comment comes with the post it sits on.
/inbox/messages/:id/hide
Messenger
Answer within Meta’s 24-hour window. Outside it the API says so with outside_messaging_window, before anything is sent.
/conversations/:id/reply
Mentions
Posts and comments that mention your Page show up in the same list. A reply goes under the post.
type=mention
“The MCP is the real game changer for me. It makes the whole workflow feel much faster and less messy.”
Ansub Khan
Founder of Supafast
Read what Facebook reports
Views, reactions by type, comments, shares and clicks per post, video views and watch time, and the Page’s followers per day. The API returns the same numbers the app charts.
AnalyticsReports
All
Impressions
11.9K26.6%
Engagements
67936.3%
Clicks
60817.6%
Engagement Rate
5.7%0.4pt
Posts8Accounts7
Post | Channels | Impressions | Likes | Comments | Shares | Clicks | Link clicks | Eng. rate | |
|---|---|---|---|---|---|---|---|---|---|
Best times to post, worked out from your own posts. Here is how it works. Oct 21, 2026 | | 3.4K | 141 | 27 | 19 | 238 | 64 | 6.8% | |
The Social Inbox has an API now. Four new endpoints for comments, DMs and mentions. Oct 19, 2026 | | 1.3K | 58 | 9 | 7 | 86 | 23 | 5.8% | |
 New: 1GB video uploads Oct 14, 2026Reel | | 2.1K | 92 | 6 | 13 | 0 | – | 5.2% | |
 New: Alt text on every image Oct 9, 2026 | | 862 | 35 | 4 | 3 | 47 | 11 | 4.9% | |
 New: PDF uploads Oct 7, 2026 | | 1.5K | 71 | 7 | 9 | 96 | 28 | 5.7% | |
 New: Mastodon threads Oct 2, 2026 | | 708 | 27 | 2 | 2 | 31 | 6 | 4.4% | |
 New in OmniSocials: Notable Days Sep 29, 2026 | | 1.2K | 53 | 5 | 8 | 72 | 19 | 5.5% | |
 Sidebar update Sep 24, 2026 | | 776 | 31 | 3 | 2 | 38 | 7 | 4.6% |
GET/v1/analytics/posts/1019
Authorization: Bearer $OMNISOCIALS_API_KEY
200 OK143 ms
01{
02 "data": {
03 "post_id": "1019",
04 "platforms": {
05 "facebook": {
06 "metrics": {
07 "views": 3412, "clicks": 238,
08 "link_clicks": 64, "likes": 141,
09 "total_reactions": 186,
10 "reactions": {
11 "like": 141, "love": 32,
12 "wow": 9, "haha": 4
13 },
14 "comments": 27, "shares": 19
15 }
16 }
17 }
18 }
19}
Per post and per Reel
Views, reactions by type, comments, shares, clicks and link clicks. Videos add views and watch time, Reels replays and follows.
/analytics/posts/:id
Per Page and workspace
A daily snapshot of the Page: followers, new and lost followers, views and profile views. Plus a workspace overview.
/analytics/accounts/analytics/overview
Best times to post
Days and hours worked out from your own Facebook history, once 15 of your posts are analyzed.
/analytics/best-times
Under the hood
Built for production
Signed webhooks, automatic retries, SDKs in 8 languages and a key per workspace. Create a key and send your first request in minutes.
Facebook’s rules, in one place
OmniSocials checks every post against them before it reaches Meta, so a bad file fails in your request, not at publish time.
Caption63,206 characters, a post needs text
First comment8,000 characters, not on Stories
PhotosJPEG, PNG, GIF or WebP, up to 10 MB each
MediaPhotos or one video per post, not both
StoryUp to 10 slides, 60 seconds per video
VideoMP4 or MOV, 100 MB in media_urls, 1 GB via upload-from-url
Messenger replyWithin 24 hours of the last message
Replies1,000 a day per workspace
Rate limit100 requests a minute per API key
AccountsFacebook Pages, one per workspace
Your first Reel in three steps
About five minutes from sign-up to a scheduled Reel on your Page. Then hand the key to your coding agent.
Create an API key
Start your trial, open Settings, API and create a key. It is shown once.
Settings › APIStep 1
Connect your Page
Sign in with Facebook in OmniSocials once and pick the Page. Then list it from your code.
GET /v1/accountsStep 2
Send your first Reel
Post now with create-and-publish, or add schedule_at to plan it.
POST /v1/posts/createStep 3
Frequently
Asked Questions
Robert LigthartFounder of OmniSocials
Ship your Facebook
integration this week.
From $10 per seat a month, API included. 14-day free trial.
https://docs.omnisocials.com