Auth0 · Schema

ConnectionOptionsFacebook

Options for the 'facebook' connection

Auth0AI AgentsAuthenticationAuthorizationFGAIdentity and Access ManagementMCPOAuthOktaOpenID ConnectSAMLSecuritySCIMIdentity Federation

Properties

Name Type Description
client_id object
client_secret object
freeform_scopes object
upstream_params object
scope object
set_user_root_attributes object
ads_management boolean Grants permission to both read and manage ads for ad accounts you own or have been granted access to by the owner. By default, your app may only access ad accounts owned by admins of the app when in d
ads_read boolean Grants access to the Ads Insights API to pull ads report information for ad accounts you own or have been granted access to by the owner of other ad accounts.
allow_context_profile_field boolean Provides access to a social context. Deprecated on April 30th, 2019.
business_management boolean Grants permission to read and write with the Business Manager API.
email boolean Grants permission to access a person's primary email address.
groups_access_member_info boolean Grants permission to publicly available group member information.
leads_retrieval boolean Grants permission to retrieve all the information captured within a lead.
manage_notifications boolean Enables your app to read a person's notifications and mark them as read. This permission does not let you send notifications to a person. Deprecated in Graph API v2.3.
manage_pages boolean Grants permission to retrieve Page Access Tokens for the Pages and Apps that the person administers. Apps need both manage_pages and publish_pages to be able to publish as a Page.
pages_manage_cta boolean Allows the app to perform POST and DELETE operations on endpoints used for managing a Page's Call To Action buttons.
pages_manage_instant_articles boolean Grants permission to manage Instant Articles on behalf of Facebook Pages administered by people using your app.
pages_messaging boolean Grants permission to send and receive messages through a Facebook Page.
pages_messaging_phone_number boolean Grants permission to use the phone number messaging feature.
pages_messaging_subscriptions boolean Grants permission to send messages using Facebook Pages at any time after the first user interaction. Your app may only send advertising or promotional content through sponsored messages or within 24
pages_show_list boolean Grants access to show the list of the Pages that a person manages.
public_profile boolean Provides access to a user's public profile information including id, first_name, last_name, middle_name, name, name_format, picture, and short_name. This is the most basic permission and is required b
publish_actions boolean Allows your app to publish to the Open Graph using Built-in Actions, Achievements, Scores, or Custom Actions. Deprecated on August 1st, 2018.
publish_pages boolean Grants permission to publish posts, comments, and like Pages managed by a person using your app. Your app must also have manage_pages to publish as a Page.
publish_to_groups boolean Grants permission to post content into a group on behalf of a user who has granted the app this permission.
publish_video boolean Grants permission to publish live videos to the app User's timeline.
read_audience_network_insights boolean Grants read-only access to the Audience Network Insights data for Apps the person owns.
read_insights boolean Grants read-only access to the Insights data for Pages, Apps, and web domains the person owns.
read_mailbox boolean Provides the ability to read the messages in a person's Facebook Inbox through the inbox edge and the thread node. Deprecated in Graph API v2.3.
read_page_mailboxes boolean Grants permission to read from the Page Inboxes of the Pages managed by a person. This permission is often used alongside the manage_pages permission.
read_stream boolean Provides access to read the posts in a person's News Feed, or the posts on their Profile. Deprecated in Graph API v2.3.
user_age_range boolean Grants permission to access a person's age range.
user_birthday boolean Grants permission to access a person's birthday.
user_events boolean Grants read-only access to the Events a person is a host of or has RSVPed to. This permission is restricted to a limited set of partners and usage requires prior approval by Facebook.
user_friends boolean Grants permission to access a list of friends that also use said app. This permission is restricted to a limited set of partners and usage requires prior approval by Facebook.
user_gender boolean Grants permission to access a person's gender.
user_groups boolean Enables your app to read the Groups a person is a member of through the groups edge on the User object. Deprecated in Graph API v2.3.
user_hometown boolean Grants permission to access a person's hometown location set in their User Profile.
user_likes boolean Grants permission to access the list of all Facebook Pages that a person has liked.
user_link boolean Grants permission to access the Facebook Profile URL of the user of your app.
user_location boolean Provides access to a person's current city through the location field on the User object. The current city is set by a person on their Profile.
user_managed_groups boolean Enables your app to read the Groups a person is an admin of through the groups edge on the User object. Deprecated in Graph API v3.0.
user_photos boolean Provides access to the photos a person has uploaded or been tagged in. This permission is restricted to a limited set of partners and usage requires prior approval by Facebook.
user_posts boolean Provides access to the posts on a person's Timeline including their own posts, posts they are tagged in, and posts other people make on their Timeline. This permission is restricted to a limited set o
user_status boolean Provides access to a person's statuses. These are posts on Facebook which don't include links, videos or photos. Deprecated in Graph API v2.3.
user_tagged_places boolean Provides access to the Places a person has been tagged at in photos, videos, statuses and links. This permission is restricted to a limited set of partners and usage requires prior approval by Faceboo
user_videos boolean Provides access to the videos a person has uploaded or been tagged in. This permission is restricted to a limited set of partners and usage requires prior approval by Facebook.
View JSON Schema on GitHub

JSON Schema

auth0-connectionoptionsfacebook-schema.json Raw ↑ 
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "#/components/schemas/ConnectionOptionsFacebook",
  "title": "ConnectionOptionsFacebook",
  "description": "Options for the 'facebook' connection",
  "type": "object",
  "allOf": [
    {
      "$ref": "#/components/schemas/ConnectionOptionsCommon"
    },
    {
      "type": "object",
      "properties": {
        "client_id": {
          "$ref": "#/components/schemas/ConnectionClientIdFacebook"
        },
        "client_secret": {
          "$ref": "#/components/schemas/ConnectionClientSecretFacebook"
        },
        "freeform_scopes": {
          "$ref": "#/components/schemas/ConnectionScopeArrayFacebook"
        },
        "upstream_params": {
          "$ref": "#/components/schemas/ConnectionUpstreamParamsFacebook"
        },
        "scope": {
          "$ref": "#/components/schemas/ConnectionScopeFacebook"
        },
        "set_user_root_attributes": {
          "$ref": "#/components/schemas/ConnectionSetUserRootAttributesEnum"
        }
      }
    },
    {
      "type": "object",
      "properties": {
        "ads_management": {
          "default": false,
          "description": "Grants permission to both read and manage ads for ad accounts you own or have been granted access to by the owner. By default, your app may only access ad accounts owned by admins of the app when in developer mode.",
          "type": "boolean"
        },
        "ads_read": {
          "default": false,
          "description": "Grants access to the Ads Insights API to pull ads report information for ad accounts you own or have been granted access to by the owner of other ad accounts.",
          "type": "boolean"
        },
        "allow_context_profile_field": {
          "default": false,
          "deprecated": true,
          "description": "Provides access to a social context. Deprecated on April 30th, 2019.",
          "type": "boolean",
          "x-release-lifecycle": "deprecated"
        },
        "business_management": {
          "default": false,
          "description": "Grants permission to read and write with the Business Manager API.",
          "type": "boolean"
        },
        "email": {
          "default": false,
          "description": "Grants permission to access a person's primary email address.",
          "type": "boolean"
        },
        "groups_access_member_info": {
          "default": false,
          "description": "Grants permission to publicly available group member information.",
          "type": "boolean"
        },
        "leads_retrieval": {
          "default": false,
          "description": "Grants permission to retrieve all the information captured within a lead.",
          "type": "boolean"
        },
        "manage_notifications": {
          "default": false,
          "deprecated": true,
          "description": "Enables your app to read a person's notifications and mark them as read. This permission does not let you send notifications to a person. Deprecated in Graph API v2.3.",
          "type": "boolean",
          "x-release-lifecycle": "deprecated"
        },
        "manage_pages": {
          "default": false,
          "description": "Grants permission to retrieve Page Access Tokens for the Pages and Apps that the person administers. Apps need both manage_pages and publish_pages to be able to publish as a Page.",
          "type": "boolean"
        },
        "pages_manage_cta": {
          "default": false,
          "description": "Allows the app to perform POST and DELETE operations on endpoints used for managing a Page's Call To Action buttons.",
          "type": "boolean"
        },
        "pages_manage_instant_articles": {
          "default": false,
          "description": "Grants permission to manage Instant Articles on behalf of Facebook Pages administered by people using your app.",
          "type": "boolean"
        },
        "pages_messaging": {
          "default": false,
          "description": "Grants permission to send and receive messages through a Facebook Page.",
          "type": "boolean"
        },
        "pages_messaging_phone_number": {
          "default": false,
          "description": "Grants permission to use the phone number messaging feature.",
          "type": "boolean"
        },
        "pages_messaging_subscriptions": {
          "default": false,
          "description": "Grants permission to send messages using Facebook Pages at any time after the first user interaction. Your app may only send advertising or promotional content through sponsored messages or within 24 hours of user interaction.",
          "type": "boolean"
        },
        "pages_show_list": {
          "default": false,
          "description": "Grants access to show the list of the Pages that a person manages.",
          "type": "boolean"
        },
        "public_profile": {
          "default": true,
          "description": "Provides access to a user's public profile information including id, first_name, last_name, middle_name, name, name_format, picture, and short_name. This is the most basic permission and is required by Facebook.",
          "type": "boolean"
        },
        "publish_actions": {
          "default": false,
          "deprecated": true,
          "description": "Allows your app to publish to the Open Graph using Built-in Actions, Achievements, Scores, or Custom Actions. Deprecated on August 1st, 2018.",
          "type": "boolean",
          "x-release-lifecycle": "deprecated"
        },
        "publish_pages": {
          "default": false,
          "description": "Grants permission to publish posts, comments, and like Pages managed by a person using your app. Your app must also have manage_pages to publish as a Page.",
          "type": "boolean"
        },
        "publish_to_groups": {
          "default": false,
          "description": "Grants permission to post content into a group on behalf of a user who has granted the app this permission.",
          "type": "boolean"
        },
        "publish_video": {
          "default": false,
          "description": "Grants permission to publish live videos to the app User's timeline.",
          "type": "boolean"
        },
        "read_audience_network_insights": {
          "default": false,
          "description": "Grants read-only access to the Audience Network Insights data for Apps the person owns.",
          "type": "boolean"
        },
        "read_insights": {
          "default": false,
          "description": "Grants read-only access to the Insights data for Pages, Apps, and web domains the person owns.",
          "type": "boolean"
        },
        "read_mailbox": {
          "default": false,
          "deprecated": true,
          "description": "Provides the ability to read the messages in a person's Facebook Inbox through the inbox edge and the thread node. Deprecated in Graph API v2.3.",
          "type": "boolean",
          "x-release-lifecycle": "deprecated"
        },
        "read_page_mailboxes": {
          "default": false,
          "description": "Grants permission to read from the Page Inboxes of the Pages managed by a person. This permission is often used alongside the manage_pages permission.",
          "type": "boolean"
        },
        "read_stream": {
          "default": false,
          "deprecated": true,
          "description": "Provides access to read the posts in a person's News Feed, or the posts on their Profile. Deprecated in Graph API v2.3.",
          "type": "boolean",
          "x-release-lifecycle": "deprecated"
        },
        "user_age_range": {
          "default": false,
          "description": "Grants permission to access a person's age range.",
          "type": "boolean"
        },
        "user_birthday": {
          "default": false,
          "description": "Grants permission to access a person's birthday.",
          "type": "boolean"
        },
        "user_events": {
          "default": false,
          "description": "Grants read-only access to the Events a person is a host of or has RSVPed to. This permission is restricted to a limited set of partners and usage requires prior approval by Facebook.",
          "type": "boolean"
        },
        "user_friends": {
          "default": false,
          "description": "Grants permission to access a list of friends that also use said app. This permission is restricted to a limited set of partners and usage requires prior approval by Facebook.",
          "type": "boolean"
        },
        "user_gender": {
          "default": false,
          "description": "Grants permission to access a person's gender.",
          "type": "boolean"
        },
        "user_groups": {
          "default": false,
          "deprecated": true,
          "description": "Enables your app to read the Groups a person is a member of through the groups edge on the User object. Deprecated in Graph API v2.3.",
          "type": "boolean",
          "x-release-lifecycle": "deprecated"
        },
        "user_hometown": {
          "default": false,
          "description": "Grants permission to access a person's hometown location set in their User Profile.",
          "type": "boolean"
        },
        "user_likes": {
          "default": false,
          "description": "Grants permission to access the list of all Facebook Pages that a person has liked.",
          "type": "boolean"
        },
        "user_link": {
          "default": false,
          "description": "Grants permission to access the Facebook Profile URL of the user of your app.",
          "type": "boolean"
        },
        "user_location": {
          "default": false,
          "description": "Provides access to a person's current city through the location field on the User object. The current city is set by a person on their Profile.",
          "type": "boolean"
        },
        "user_managed_groups": {
          "default": false,
          "deprecated": true,
          "description": "Enables your app to read the Groups a person is an admin of through the groups edge on the User object. Deprecated in Graph API v3.0.",
          "type": "boolean",
          "x-release-lifecycle": "deprecated"
        },
        "user_photos": {
          "default": false,
          "description": "Provides access to the photos a person has uploaded or been tagged in. This permission is restricted to a limited set of partners and usage requires prior approval by Facebook.",
          "type": "boolean"
        },
        "user_posts": {
          "default": false,
          "description": "Provides access to the posts on a person's Timeline including their own posts, posts they are tagged in, and posts other people make on their Timeline. This permission is restricted to a limited set of partners and usage requires prior approval by Facebook.",
          "type": "boolean"
        },
        "user_status": {
          "default": false,
          "deprecated": true,
          "description": "Provides access to a person's statuses. These are posts on Facebook which don't include links, videos or photos. Deprecated in Graph API v2.3.",
          "type": "boolean",
          "x-release-lifecycle": "deprecated"
        },
        "user_tagged_places": {
          "default": false,
          "description": "Provides access to the Places a person has been tagged at in photos, videos, statuses and links. This permission is restricted to a limited set of partners and usage requires prior approval by Facebook.",
          "type": "boolean"
        },
        "user_videos": {
          "default": false,
          "description": "Provides access to the videos a person has uploaded or been tagged in. This permission is restricted to a limited set of partners and usage requires prior approval by Facebook.",
          "type": "boolean"
        }
      }
    }
  ],
  "additionalProperties": true
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This JSON Schema 
curl "https://apis.io/api/v1/json-schemas/auth0-connectionoptionsfacebook"
All schemas 
curl "https://apis.io/api/v1/json-schemas?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.