Skip to main content

Facebook Pages

Availability
Available CoreAvailable StandardAvailable PlusAvailable ProAvailable Enterprise FlexAvailable Self-Managed EnterpriseAvailable PyAirbyte
Support Level
Marketplace
Connector Version
2.0.3 (last updated 7 days ago)
CDK Version
6.48.10
Sync Success Rate
Usage Rate
Definition ID
010eb12f-837b-4685-892d-0a39f76a98f5

This page contains the setup guide and reference information for the Facebook Pages source connector.

Prerequisites​

To set up the Facebook Pages source connector with Airbyte, you'll need to create your Facebook Application and use both long-lived Page access token and Facebook Page ID.

note

The Facebook Pages source connector is currently only compatible with v24 of the Facebook Graph API.

Setup guide​

Step 1: Set up Facebook Pages​

  1. Create a Facebook Developer Account. Follow these instructions to create one.
  2. Create a Facebook App. Choose "Company" as the purpose of the app. Fill out the remaining fields to create your app, then follow along the "Connect a User Page" section.
  3. Connect a User Page using the Graph API Explorer. Choose your app in the Meta App field. Choose your Page in the User or Page field. Add the following permissions:
    • pages_read_engagement
    • pages_read_user_content
    • pages_show_list
    • read_insights
  4. Click Generate Access Token and follow instructions.

After all the steps, it should look something like this:

  1. Generate Long-Lived User Access Token.
  2. Generate Long-Lived Page Token.

Step 2: Set up the Facebook Pages connector in Airbyte​

For Airbyte Cloud:​

  1. Log into your Airbyte Cloud account.
  2. In the left navigation bar, click Sources. In the top-right corner, click + New source.
  3. On the Set up the source page, enter the name for the Facebook Pages connector and select Facebook Pages from the Source type dropdown.
  4. Fill in Page Access Token with Long-Lived Page Token
  5. Fill in Page ID (if you have a page URL such as https://www.facebook.com/Test-1111111111, the ID would be Test-1111111111)

For Airbyte OSS​

  1. Navigate to the Airbyte Open Source dashboard.
  2. Set the name for your source.
  3. On the Set up the source page, enter the name for the Facebook Pages connector and select Facebook Pages from the Source type dropdown.
  4. Fill in Page Access Token with Long-Lived Page Token
  5. Fill in Page ID (if you have a page URL such as https://www.facebook.com/Test-1111111111, the ID would be Test-1111111111)

Creating your own OAuth App​

Follow this Facebook documentation to create an OAuth App.

Required permissions for your OAuth App to sync data using the Facebook Pages source connector:

  • pages_read_engagement
  • pages_read_user_content
  • pages_show_list
  • read_insights

If you encounter permission errors for specific Page fields, see Meta's Permissions Reference for additional permissions you might need. As a rule it's best to request the lowest number of permissions you can to function normally.

Supported sync modes​

The Facebook Pages source connector supports the following sync modes:

Supported Streams​

Data type map​

Integration TypeAirbyte TypeNotes
stringstring
numbernumber
arrayarray
objectobject

Performance considerations​

Facebook heavily throttles API tokens generated from Facebook Apps by default, making it infeasible to use such a token for syncs with Airbyte. To be able to use this connector without your syncs taking days due to rate limiting, follow the instructions in the Setup Guide above to generate a Long-Lived Page Token.

See Facebook's documentation on rate limiting for more information on requesting a quota upgrade.

Reference​

Config fields reference

Field
Type
Property name
string
access_token
string
page_id

Changelog​

Expand to review
VersionDatePull RequestSubject
2.0.32025-12-0170248Use correct pagination parameter name (limit instead of page_size)
2.0.22025-12-0170258Use Post stream for check, handle 400 error in Page stream
2.0.12025-11-2770242Refresh in-app documentation to reflect v24 API version
2.0.02025-11-1869714Upgrade Facebook API to v24.0
1.1.42025-07-3164141Upgrade Facebook API to v23.0
1.1.32025-07-1260391Update dependencies
1.1.22025-05-1060043Update dependencies
1.1.12025-05-0353787Update dependencies
1.1.02025-04-3059126Re-enable in cloud and update versions
1.0.322025-02-0152793Update dependencies
1.0.312025-01-2752122Upgrade Facebook API to v21.0
1.0.302025-01-2552373Update dependencies
1.0.292025-01-1851637Update dependencies
1.0.282025-01-1151056Update dependencies
1.0.272025-01-0450923Update dependencies
1.0.262024-12-2850530Update dependencies
1.0.252024-12-2149997Update dependencies
1.0.242024-12-1449154Starting with this version, the Docker image is now rootless. Please note that this and future versions will not be compatible with Airbyte versions earlier than 0.64
1.0.232024-10-2947737Update dependencies
1.0.222024-10-2147025Update dependencies
1.0.212024-10-1246807Update dependencies
1.0.202024-10-0546461Update dependencies
1.0.192024-09-2846133Update dependencies
1.0.182024-09-2145734Update dependencies
1.0.172024-09-1445563Update dependencies
1.0.162024-09-0745311Update dependencies
1.0.152024-08-3145052Update dependencies
1.0.142024-08-2444664Update dependencies
1.0.132024-08-1744234Update dependencies
1.0.122024-08-1243729Update dependencies
1.0.112024-08-1043477Update dependencies
1.0.102024-08-0343224Update dependencies
1.0.92024-07-2742787Update dependencies
1.0.82024-07-2042255Update dependencies
1.0.72024-07-1341685Update dependencies
1.0.62024-07-1041543Update dependencies
1.0.52024-07-0941126Update dependencies
1.0.42024-07-0640812Update dependencies
1.0.32024-06-2540500Update dependencies
1.0.22024-06-2240058Update dependencies
1.0.12024-06-0639243[autopull] Upgrade base image to v1.2.2
1.0.02024-03-1436015Upgrade Facebook API to v19.0
0.3.02023-06-2627728License Update: Elv2
0.2.52023-04-1326939Add advancedAuth to the connector spec
0.2.42023-04-1325143Update insight metrics request params
0.2.32023-02-2323395Parse datetime to rfc3339
0.2.22023-02-1022804Retry 500 errors
0.2.12022-12-2920925Fix tests; modify expected records
0.2.02022-11-2419788Migrate lo low-code; Beta certification; Upgrade Facebook API to v.15
0.1.62021-12-229032Remove deprecated field live_encoders from Page stream
0.1.52021-11-268267updated all empty objects in schemas for Page and Post streams
0.1.42021-11-26Remove unsupported insights_export field from Pages request
0.1.32021-10-287440Generate Page token from config access token
0.1.22021-10-187128Upgrade Facebook API to v.12
0.1.12021-09-306438Annotate Oauth2 flow initialization parameters in connector specification
0.1.02021-09-015158Initial Release
Was this page helpful?