How to Set Up the Facebook & Instagram Integration

The Meta integration allows you to import all data from engagement with your article-related posts from your Facebook pages and Instagram accounts into your Marfeel account. This includes numbers of posts, comments, shares, likes, and followers. All data is available in the Explore module and Compass playbook. For a deeper dive on the social media module and how to get the most out of it, see the user guide.

Set up the Meta Integration

  1. Go to the Organization icon in sidebar, and select Integrations. Scroll down to find ‘Social’ section.
  2. Click on Connect in the Meta integration box. You will see the following prompt:
  3. Add a valid App Id, App secret and User token. There are instructions in the next section on how to obtain them. Confirm, and you’ll be shown a dropdown with all pages it found access to. Select the ones you want to connect and confirm.
  4. Integration setup is complete.
Instagram account access
If you want Meta integration to be able to sync all data from your Instagram accounts, you need to make sure they are connected to the Facebook pages you add in the integration. You can connect them by following the instructions provided in Instagram's documentation.

Obtaining the Facebook Credentials

  1. Important: you must use a Facebook account that is admin to the page you want to show in the card.
  2. Go to Meta for developers and click on My Apps and then on Create App.
  3. Fill in the form selecting app type: Business. Add any name for it. You’ll be prompted for a password.
  4. Go into your app’s Settings > Basic
    1. Add your site’s Privacy Policy URL, set Category to Business and Pages, and save your changes.
    2. Get App ID and App Secret
  5. Go to Tools > Graph API explorer
  6. Select your app, add permissions:
    • pages_read_engagement from group ‘Events Groups Pages’
    • pages_show_list from group ‘Events Groups Pages’
    • pages_read_user_content from group ‘Events Groups Pages’
    • read_insights from group ‘Other’
If the pages you are adding relater to Instagram accounts as well, and you want their data to be synced, please add the following permissions, too.
  • instagram_basic
  • instagram_manage_insights

and click on Generate Access Token. You’ll be prompted for permission, and you will need to select which page(s) you want to grant this access to.

  1. You will need to confirm permissions, keep both selected, and confirm:
  2. Copy the generated access token. Bear in mind that it is only valid for 5 minutes!


Sometimes the integration may experience problems fetching the data related from the pages you are syncing. In these cases, you may notice that some posts are missing, not being shown in Editorial Details or in Explore. You can find more information in the Logs tab inside the integration.

Common issues are listed below:

FacebookGraphException: Received Facebook error response of type null: Please reduce the amount of data you’re asking for, then retry your request

This error impacts certain pages, normally large ones, and it comes from an unsolved Facebook bug. Please contact Marfeel support.

FacebookOAuthException: Received Facebook error response of type OAuthException: (#10) This endpoint requires the ‘pages_read_user_content’ permission or the ‘Page Public Content Access’ feature.

This error comes from a wrong token creation. Please regenerate the token following the instructions above and try deleting and creating the integration from scratch.

FacebookGraphException: Received Facebook error response of type null: An unknown error occurred

Please contact Marfeel support.