Meta (Facebook & Instagram)

The Meta connector lets the CMO publish to a Facebook Page and an Instagram business account through the Graph API and read back post-level engagement to score what works. Instagram publishing uses Meta’s container flow: the connector creates the media container, polls it to readiness, then publishes — including multi-image carousels. Every post runs through the same pipeline as other channels: brand-voice match, the Quality Gate, and per-channel scheduling.

Two narrower connectors, Facebook and Instagram, are also listed in Settings for tenants that only want one surface or need the stricter stage-then-publish tools; they take the same Page token and Page / Instagram account IDs.

Before you start

• Plan: any plan. Counts as one integration toward your plan’s quota.
• A Facebook Page you administer and, for Instagram tools, an Instagram business or creator account linked to that Page. You need both numeric IDs: the Page ID (Page → About → Page transparency) and the Instagram business account ID (Graph API Explorer: /{page-id}?fields=instagram_business_account).
• A Page access token from a Meta developer app with these permissions: pages_manage_posts, pages_read_engagement, pages_show_list, instagram_business_content_publish, instagram_business_manage_insights. Generate a long-lived user token in Graph API Explorer, then request /{page-id}?fields=access_token to get the Page token.
• The token you paste is used as-is against Graph API v21.0. Page tokens derived from a long-lived user token do not expire on their own, but they are invalidated if you change your password or remove the app; the connector then reports error and you paste a new token via Reconnect.

Connect

1. Open Settings → Connectors and click + on Meta.
2. Paste the token into Provider access token, and enter the numeric Facebook Page ID and Instagram business account ID.
3. Click Verify and connect. The platform calls GET /me with the token; if Meta rejects it, nothing is saved.
4. Meta appears under Connected.

Connector tools

Tool	Action	What it does
create_facebook_post	write	Post to the Page with text and an optional link or image
publish_instagram_post	write	Publish an image post to Instagram via the container flow
publish_instagram_carousel	write	Publish a multi-image carousel to Instagram
get_facebook_insights	read	Post-level insights for a Facebook post
get_instagram_insights	read	Media-level insights for an Instagram post

Permissions

See Permission model. Publishing is an agent action routed through the Quality Gate and your autonomy level; at lower autonomy levels posts wait in your approval queue. A Graph API 429 puts the connector into rate_limited until the next successful call.

Disconnect

Click the trash icon on the Meta row and confirm; the token is revoked from the vault. To revoke on Meta’s side, remove the app under Settings → Business integrations on Facebook.