@devries-cameron20 / composio Mirror · read-only
Fork 0

Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.

Mirrored from https://github.com/Camo67/composio.git

Synced Nov 21, 06:00 UTC

next
md 32 lines 2.5 KB
Rendered Raw
1 ## How do I set up custom OAuth credentials for Meta (Facebook)?
2
3 Use your own Meta app when you want users to see your app's name on the consent screen and control the credentials yourself.
4
5 ### Create the Meta app
6
7 1. Sign in to [Meta for Developers](https://developers.facebook.com/) and register as a developer if you haven't. Your app must be linked to a [business portfolio](https://business.facebook.com/).
8 2. Click **Create App**. Enter the app details, select the use cases your workflow needs, and on the business step select your business portfolio. Complete the remaining fields and create the app.
9
10 ![Meta for Developers Apps page with the Create App button](/images/toolkits/facebook/create-app.webp)
11
12 ![Meta Create an app business step for choosing a business portfolio](/images/toolkits/facebook/business-portfolio.webp)
13 3. In **App settings** > **Basic**, copy the **App ID** (client ID) and **App Secret** (client secret).
14
15 ![Meta App settings Basic page with App ID and App secret](/images/toolkits/facebook/app-settings-basic.webp)
16 4. Add `https://backend.composio.dev/api/v1/auth-apps/add` to the app's OAuth redirect allow list (in **App settings** > **Advanced**, or **Valid OAuth Redirect URIs** in the Facebook Login settings). It must exactly match the `oauth_redirect_uri` field in your Composio auth config.
17 5. Publish the app.
18
19 ### Create the auth config in Composio
20
21 1. In the Composio dashboard, go to **Auth Configs**, click **Create Auth Config**, and select **Facebook**.
22 2. Keep the authentication type as **OAuth2** and choose **Use your own developer authentication**.
23
24 ![Use your own developer credentials toggle turned on in the Facebook auth config form](/images/toolkits/facebook/own-credentials-toggle.webp)
25 3. Paste the **App ID** as the **Client ID** and the **App Secret** as the **Client Secret**, then click **Create Facebook Auth Config**.
26 4. Click **Connect Account**, approve access in Facebook, and confirm the account shows as **Active**.
27
28 See [Custom auth configs](/docs/auth-configuration/custom-auth-configs) for the general flow.
29
30 ### Scopes
31
32 The default auth config requests `public_profile`, `email`, `business_management`, `pages_show_list`, `pages_read_engagement`, `pages_manage_posts`, `pages_manage_engagement`, `pages_read_user_content`, `pages_manage_metadata`, `pages_messaging`, and `read_insights`. Edit the **Scopes** field on the auth config to request only what you use. Meta requires App Review before people without a role on your app can grant most of these permissions.