​
Configuration

Connect to Facebook Pages and sync posts, insights, and engagement metrics. Provide the following configuration parameters:

KeyDescriptionSample ValueRequired
access_tokenOAuth access token for Facebook Graph API with the required permissions (pages_read_engagement, pages_read_user_content).EAABsbCS1i...✅
page_idsList of Facebook Page IDs you want to extract data from.["1234567890", "9876543210"]✅
start_dateStart date (ISO 8601 format) to begin fetching posts and engagement data.2025-01-01T00:00:00Z✅

​
How to Get Your access_token

You have two options to generate an access token:

  • Click the OAuth Authorize button in your Mage workspace.
  • Approve the required Facebook permissions:
    • pages_show_list
    • pages_read_engagement
    • pages_read_user_content
    • read_insights
  • The access token will be securely generated and auto-filled in the configuration.

Tip: Use the OAuth flow for a smoother, safer authentication process without manually handling tokens.

​
2. Manually Generate Access Token

  • Create a Facebook App via Facebook Developer Portal.
  • Configure the app and get the permissions listed above.
  • Generate a User Access Token or Page Access Token via Graph API Explorer.
  • (Optional) Exchange for a long-lived token for production environments.

​
What is Facebook Pages API?

The Facebook Pages API allows programmatic access to posts, insights, page metadata, and engagement data for Facebook Pages. Businesses use it to monitor social presence, measure engagement, and automate reporting workflows.


​
Why Integrate Facebook Pages with Mage?

  • Automate data extraction: Fetch page posts, reactions, and comments for analysis.
  • Engagement tracking: Monitor likes, shares, comments, and post performance.
  • Insights at scale: Integrate page metrics into BI dashboards for better reporting.
  • Marketing analytics: Correlate Facebook engagement with other marketing activities.

​
Supported Streams

The Facebook Pages source extracts the following resources:

  • page: Basic page details like name, ID, and metadata.
  • page_insights: Aggregated metrics like page impressions, engagement, and follower growth.
  • post_attachments: Media and links attached to posts.
  • post_insights: Detailed insights for each post, including reach and engagement breakdown.
  • post_tagged_profile: Profiles tagged in the posts.
  • posts: Content posted on the page — text, images, videos, and links.