Facebook API

Facebook API for posting and scheduling without the Meta app review maze

Add Facebook publishing to products that publish Page posts, Reels, Stories, and local campaigns with one API for scheduling, media, status, and reporting workflows.

Last updated: May 2026

API key authScheduled publishing14 platforms
Quick start
API request
1await fetch("https://api.bundle.social/api/v1/post", {2  method: "POST",3  headers: {4    "x-api-key": process.env.BUNDLE_SOCIAL_API_KEY,5    "Content-Type": "application/json"6  },7  body: JSON.stringify({8    teamId: "team_123",9    title: "Facebook campaign",10    postDate: "2026-05-14T10:00:00.000Z",11    status: "SCHEDULED",12    socialAccountTypes: ["FACEBOOK"],13    data: {14      FACEBOOK: { text: "Scheduled from bundle.social." }15    }16  })17});

Building directly on Facebook Graph API

Facebook Graph API work brings app review, page tokens, permissions, channel selection, and media handling.
Page posts, Reels, Stories, links, and native scheduling each ask for different fields.
Publishing alone is not enough when teams also need status, retries, analytics, and reports.

What bundle.social handles

Schedule Facebook content from the same post workflow you use for every other channel.
Handle links, media, Reels, Stories, and native schedule fields when the connected Page allows them.
Track Facebook publishing and analytics beside the rest of your social channels.

Facebook Page publishing without token firefighting

Page posts, Reels, Stories, links, and native scheduling all depend on Meta permissions and token health. bundle.social keeps that complexity behind a repeatable publishing workflow.

Workflow

How it works

Connect accounts once, then create and schedule posts with channel-specific fields from one API.

01

Create an API key

Generate an organization API key in the dashboard and use it with the x-api-key header.

02

Connect accounts

Connect each social account once. bundle.social keeps the account mapping ready for future posts.

03

Create or schedule posts

Send one request with the publish date, selected channels, and the fields each platform needs.

Capabilities

Facebook API workflows for Page-owned campaigns

Page tokens, content-type fields, media, native scheduling, status, and reporting context for Facebook publishing.

Facebook-specific payload fields

Control the fields that matter on Facebook: captions, media types, privacy settings, and more, using the same post endpoint as every other channel.

API key authentication

Use one bundle.social API key for server-to-server requests. Your users still connect social accounts once through the hosted OAuth flow; bundle.social handles token storage and refresh.

Scheduling built in

Set a postDate to schedule Facebook content in advance, or create drafts and queue posts through the dashboard.

Media library integration

Upload Facebook-compatible media once and reference the same upload ID across multiple posts or campaigns.

Post status and retry tracking

Track Facebook posts through scheduled, processing, posted, retrying, and error states from the API or the shared dashboard.

Cross-platform publishing

Add other channels to the same post payload when Facebook is part of a multi-platform campaign. No separate API calls needed.

Platform specifics

Facebook Graph API details for Page publishing

Facebook looks familiar to users, but Page publishing still depends on token health, permissions, and content-type rules.

Page tokens expire

Facebook Page access tokens commonly expire after about 60 days. bundle.social refreshes them where possible, but security changes, revoked permissions, or Meta-side failures can still require users to reconnect.

Reels have API-specific limits

Facebook Reels via API support videos from 3 seconds to 8 minutes and require at least 540x960 resolution.

Long text is possible

Page post text can reach 50,000 characters, links up to 2,048 characters, and media titles up to 255 characters.

Developer example

Schedule a Facebook post

Examples use bundle.social's public API shape: API key authentication, a post date, selected social account types, and platform-specific data.

TypeScript
API request
1await fetch("https://api.bundle.social/api/v1/post", {2  method: "POST",3  headers: {4    "x-api-key": process.env.BUNDLE_SOCIAL_API_KEY,5    "Content-Type": "application/json"6  },7  body: JSON.stringify({8    teamId: "team_123",9    title: "Facebook campaign",10    postDate: "2026-05-14T10:00:00.000Z",11    status: "SCHEDULED",12    socialAccountTypes: ["FACEBOOK"],13    data: {14      FACEBOOK: { text: "Scheduled from bundle.social." }15    }16  })17});

Supported content

Page postsReelsStoriesImagesVideosLinksNative scheduling

Honest limitations

  • Facebook permissions, page access, and app review remain controlled by Meta.
  • Native scheduling fields are Meta-specific and only apply to eligible Facebook content.

Guarantees

Developer-first infrastructure

2% error rate

We handle the platform edge cases, media processing, and rate limits so your requests succeed.

Verbose errors

When native APIs fail, we return human-readable error messages and actionable recovery steps.

Flat pricing

No per-post counting. Predictable pricing for teams managing many users, workspaces, and connected accounts.

Same-day support

Direct access to the engineers building the API. We respond to technical issues the same day. Sometimes the same hour. Test us c;

Resources

Technical guides & documentation

FAQ

Questions developers ask before building

Can I publish to Facebook through bundle.social?

Yes, for supported Facebook account types and permissions. bundle.social exposes the Facebook fields you need inside a broader scheduled post workflow.

Does this replace Facebook Graph API?

No. bundle.social runs on top of native platform APIs and reduces the work around publishing, scheduling, status, media, and reporting.

Can I schedule Facebook posts?

Yes. Send a future postDate, set status to SCHEDULED, and include the FACEBOOK payload.

Can I use Facebook with other platforms?

Yes. Facebook can run in the same workflow as your other supported social channels.

Are Facebook analytics supported?

Facebook analytics are available when the connected account and native API expose the data.