Facebook Integration | Documentation

Publish text updates, photos, and video to the Facebook Pages you administer. One connection can cover several Pages — you pick which one each post goes to.

At a glance

What it's for	Page posts — text, photos, and video.
Post types	Text, Image, Video
Account needed	A Facebook Page you administer. Personal profiles cannot be posted to through the API.
How you connect	OAuth — you approve the Pages you want, and pick which of them to post to.
Posts target a	Page — pick one when you connect, and reference it by nickname on each post.
Content archiving	Published posts are backed up automatically.

Connecting your account

Add Facebook from your Accounts page. Facebook shows you the Pages you administer; approve the ones you want to publish to. Each approved Page becomes a target you can pick when composing a post.

You never handle Page IDs. Give each Page a nickname when you connect it, and reference that nickname — in the app, through the API, or when asking an AI assistant to post. We resolve it to the right Page at publish time.

Personal Facebook profiles cannot be posted to. Meta's API covers Pages only.

What you type, and where it shows up

Facebook is the one platform here where the Title behaves differently depending on the post type. A feed post — text or photos — has no title at all. A video post does: the title goes into your Page's video library, where it's how you find the video later.

A Facebook text post. Every post also names the Page it publishes to. Fields marked * are required.

You type	Text post	Image post	Video post
Title	No title field. Used as the post text only when Content is empty.	No title field. Used as the post text only when Content is empty.	The video title in your Page's video library.
Content	The post message.max 10,000 characters	The post message.max 10,000 characters	The post message.max 10,000 characters
Tags	Appended as #hashtags to the message.	Appended as #hashtags to the message.	Appended as #hashtags to the message.
Link	Sent as the post's link, which Facebook expands into a preview card.	Appended to the message as a visible URL.	Appended to the message as a visible URL.
Privacy	Sets the post's audience on the Page.	Sets the post's audience on the Page.	Sets the post's audience on the Page.

Links behave differently by post type too. On a text-only post, your Link is sent as the post's link and Facebook expands it into a preview card. On a post with photos or video attached, Facebook won't accept both — so the link is added to the message as a visible URL instead of being dropped.

Media requirements

Images per post	up to 10 (at least 1)
Image formats	JPG, PNG, GIF, WEBP
Max image size	10.0 MB
Video formats	MP4, MOV, AVI
Max video size	10.0 GB
If your file doesn't fit	We convert it for you where we can — images become JPG and video becomes MP4. Files we can't bring within these limits are reported before the post is scheduled, not after.

Per-post options

Option	What it does	Default	Applies to
Save as Draft`saveAsDraft`	Save as draft for later editing instead of publishing immediately	Off	All post types

These are the options Facebook exposes to partner tools through its API. Platforms often test new settings inside their own app long before opening them to tools like ours — when that happens the option simply isn't available to us until they publish it.

Save as Draft creates the post unpublished on the Page, where you can review and publish it from Meta Business Suite.

Scheduling

Schedule Facebook posts for any future time — see Scheduled Posting for how times, timezones, and cancellation work.

Metrics

Metric	Status
Likes & comments	Available
Views / plays	Available
Reach / impressions	Available
Follower count	Available
Shares / reposts / saves	Available
Comment text (needed to read & reply to comments)	Available

Metrics are reported per Page. If reach is missing on a Page you connected a while ago, reconnect it — the permission that supplies it was granted after that token was issued.

Where it works

In the app	Create a post or schedule one, and select this account. Bulk sessions work too.
API	Post and schedule through the REST API with the same fields shown above. Name the Page you're posting to by its nickname.
MCP (Claude, ChatGPT, and others)	Connect Greenwood Social as an MCP connector and ask your assistant to draft and schedule posts. Name the Page you're posting to by its nickname.