Facebook - Nango Docs

🚀 Quickstart

Connect to Facebook with Nango and see data flow in 2 minutes.

Create the integration

In Nango (free signup), go to Integrations -> Configure New Integration -> Facebook.

Authorize Facebook

Go to Connections -> Add Test Connection -> Authorize, then log in to Facebook. Later, you’ll let your users do the same directly from your app.

Call the Facebook API

Let’s make your first request to the Facebook API (fetch authenticated user profile information). Replace the placeholders below with your secret key, integration ID, and connection ID:

cURL
Node

curl "https://api.nango.dev/proxy/me?fields=id,name,email" \
  -H "Authorization: Bearer <NANGO-SECRET-KEY>" \
  -H "Provider-Config-Key: <INTEGRATION-ID>" \
  -H "Connection-Id: <CONNECTION-ID>"

Install Nango’s backend SDK with npm i @nangohq/node. Then run:

import { Nango } from '@nangohq/node';

const nango = new Nango({ secretKey: '<NANGO-SECRET-KEY>' });

const res = await nango.get({
    endpoint: '/me',
    params: {
      fields: 'id,name,email'
    },
    providerConfigKey: '<INTEGRATION-ID>',
    connectionId: '<CONNECTION-ID>'
});

console.log(res.data);

Or fetch credentials with the Node SDK or API.✅ You’re connected! Check the Logs tab in Nango to inspect requests.

Implement Nango in your app

Follow our Auth implementation guide to integrate Nango in your app.To obtain your own production credentials, follow the setup guide linked below.

📚 Facebook Integration Guides

Nango maintained guides for common use cases.

How to register your own Facebook OAuth app
Register an OAuth app with Facebook and obtain credentials to connect it to Nango

Official docs: Facebook API docs

🧩 Pre-built syncs & actions for Facebook

Enable them in your dashboard. Extend and customize to fit your needs.

Comments

Function name	Description	Type	Source code
`create-post-comment`	Create a comment on a Facebook post	Action	🔗 Github
`delete-comment`	Delete a Facebook comment by comment ID	Action	🔗 Github
`get-comment`	Retrieve a Facebook comment by comment ID.	Action	🔗 Github

Page Posts

Function name	Description	Type	Source code
`create-page-post`	Publish a post to a Facebook Page feed.	Action	🔗 Github

Page Subscriptions

Function name	Description	Type	Source code
`get-page-app-subscriptions`	Retrieve app subscriptions configured on a Facebook Page	Action	🔗 Github

Page Videos

Function name	Description	Type	Source code
`create-page-video`	Publish a video to a Facebook Page.	Action	🔗 Github

Pages

Function name	Description	Type	Source code
`create-page-photo`	Publish a photo to a Facebook Page.	Action	🔗 Github
`get-page`	Retrieve Facebook Page metadata by page ID	Action	🔗 Github
`list-page-scheduled-posts`	List scheduled posts for a Facebook Page	Action	🔗 Github
`list-page-videos`	List videos published on a Facebook Page	Action	🔗 Github
`list-user-pages`	List Facebook Pages the authenticated user can access	Action	🔗 Github
`subscribe-app-to-page`	Subscribe the app to receive updates for a Facebook Page	Action	🔗 Github
`unsubscribe-app-from-page`	Remove the app subscription from a Facebook Page	Action	🔗 Github

Posts

Function name	Description	Type	Source code
`create-scheduled-page-post`	Schedule a future post on a Facebook Page	Action	🔗 Github
`delete-post`	Delete a Facebook Page post by post ID	Action	🔗 Github
`get-post`	Retrieve a Facebook post by post ID	Action	🔗 Github
`list-page-posts`	List posts from a Facebook Page feed.	Action	🔗 Github

Users

Function name	Description	Type	Source code
`get-user-profile`	Retrieve the authenticated Facebook user profile or another accessible user object.	Action	🔗 Github

Others

Function name	Description	Type	Source code
`list-post-comments`	List comments on a Facebook post with pagination support	Action	🔗 Github
`page-posts`	Sync posts from Facebook Pages the connection can access.	Sync	🔗 Github
`page-scheduled-posts`	Sync scheduled unpublished posts for Facebook Pages in scope	Sync	🔗 Github
`page-videos`	Sync videos published on Facebook Pages in scope.	Sync	🔗 Github
`pages`	Sync Facebook Pages the authenticated user can access	Sync	🔗 Github

​🚀 Quickstart

​📚 Facebook Integration Guides

​🧩 Pre-built syncs & actions for Facebook

​Comments

​Page Posts

​Page Subscriptions

​Page Videos

​Pages

​Posts

​Users

​Others