Facebook API

Facebook Page Publishing API Without the OAuth Headache

Aether manages Facebook's complex permission scopes, token refresh cycle, and cross-posting logic. Connect your Pages and start publishing in minutes.

facebook-example.ts
import Aether from "aether";

const aether = new Aether({ apiKey: process.env.AETHER_API_KEY });

const post = await aether.posts.create({
  text: "Big announcement from the team 📢\n\nWe just launched...",
  profileIds: ["fb_page456", "ig_abc123"], // post to both simultaneously
  media: [{ url: "https://cdn.yourbrand.co/banner.jpg", type: "image" }],
  platforms: {
    facebook: { contentType: "post" },
    instagram: { contentType: "reel" },
  },
  scheduledFor: "2026-06-02T10:00:00Z",
});
// → { id: "post_fb1", status: "scheduled", platforms: ["facebook", "instagram"] }

Note: Facebook API requires a Facebook Page (not a personal profile). Personal profiles cannot be connected to third-party apps — this is a Meta platform policy.

Aether vs Meta Graph API

Ship in minutes instead of weeks.

FeatureAetherMeta Graph API
Permission scopesHandled by Aether's connect flowComplex scope management your team owns
Token refreshAutomatic — tokens never expire on your endManual refresh every 60 days
Cross-postingFacebook + Instagram in one API callTwo separate API integrations
AuthenticationOne API keyApp Review + OAuth 2.0
API maintenanceWe absorb all breaking changesYour team's responsibility
Platform complianceOfficial API, fully compliantOfficial API, fully compliant

Supported content types

PostsPhotosVideosStoriesReels

How it works

01

Get your API key

Sign up for free — no credit card required. Your API key is ready instantly in the dashboard.

02

Connect accounts

Generate a branded connect link. Your users click it, authenticate with the platform, and the account appears in your dashboard.

03

Start posting

One API call. Aether handles OAuth, rate limits, media hosting, and platform-specific formatting.

Frequently asked questions

Does this work with Facebook personal profiles?+

No — Meta's API policy restricts posting to Pages and Groups only. Personal profiles cannot be connected to third-party apps. You need a Facebook Page to use the API, which is free to create from your personal account.

Can I post to Facebook Groups through Aether?+

Facebook Groups API access requires Group admin approval within each group. You can connect your Page instantly. Group posting works for groups where you're an admin and API access has been enabled.

How does cross-posting with Instagram work?+

If your Facebook Page is linked to an Instagram Business account via Meta Business Suite, you can post to both simultaneously with one API call using multiple profileIds. Aether handles the platform-specific formatting for each automatically.

Do I need to manage Facebook's long-lived token refresh?+

No. Aether automatically refreshes Facebook Page access tokens before they expire. The token lifecycle is entirely managed on our end — you just use the API.

Can I post to multiple Facebook Pages at once?+

Yes. Each Page is a separate connected profile with its own profileId. Pass multiple profileIds in one API call to post to all of them simultaneously with identical or per-platform customized content.

Does Aether support Facebook Reels?+

Yes. Use contentType: 'reel' in the platforms.facebook override and provide a video file. Facebook Reels requires a minimum 3-second video and follows similar format requirements to Instagram Reels.

One API

Facebook is just one of seven platforms

The same API call publishes to every platform. Mix and match platforms in a single request.

Connect all your platforms →