Facebook - SocialAPI.AI

Available Managed connector - SocialAPI handles the Meta App and platform app review for you. No customer-side Meta for Developers registration required. See Platform credentials. Facebook Pages are fully supported. The connector uses the Meta Graph API for posts, comments, DMs (Messenger), and mentions.

At a glance

Field	Value
Platform slug	`facebook`
Auth type	OAuth 2.0 (Meta)
API	Meta Graph API
Best for	Page-level engagement: post and reply on Facebook Pages.

Capabilities

Feature	Supported	Notes
List posts	Yes	Page feed posts
Comments	Yes	Scoped to a specific post
Reply to comment	Yes
Private reply	Yes	Sends a one-time DM to the commenter
Comment replies (thread)	Yes	Fetch the reply thread under a comment
Moderate comment (hide/unhide/delete)	Yes
Toggle post comments	No	Not supported by Facebook Graph API
DMs	Yes	Via Messenger (24-hour messaging window)
Send DM	Yes	Text and/or media attachment (`attachment_url`)
Send DM attachment	Yes	Image, video, audio, or file via `attachment_url` (type inferred from URL extension, max 25 MB), or by `attachment_id` (requires `attachment_type`)
Get DM thread by user	Yes
Reviews	No	Deprecated in Graph API v22.0
Mentions	Yes	Posts where the Page is tagged
Reply to mention	Yes	Posts a public comment reply on a mention (post or comment mention)
Like/unlike comment	Yes	Page can like or unlike a comment
Create post	Yes	Text, photos, links, videos, Reels (set `content_type: reel` in platform_data)
Delete post	Yes

Connecting

curl -X POST https://api.social-api.ai/v1/accounts/connect \
  -H "Authorization: Bearer $SOCAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "platform": "facebook",
    "redirect_uri": "https://app.example.com/oauth/callback",
    "state": "session_abc123"
  }'

Response:

{
  "auth_url": "https://www.facebook.com/v25.0/dialog/oauth?client_id=...&state=...",
  "state": "4a8f2c1e9b3d7f06a5c2e8b4d1f3a7e2"
}

Redirect your user to auth_url. After they authorize, SocialAPI exchanges the code with Facebook, but the result is never an immediate status=success: every Facebook connect returns a pending connection that asks you to choose which Pages to assign. See OAuth flows: Facebook, choosing which Pages to connect for the full login_id / pages[] / lost_access[] shape and the POST /v1/accounts/pending/{connection_id}/select call that completes it. A Facebook login is a shared credential, not a one-to-one link to a brand. The same login can serve many brands at once: each Page you have access to belongs to exactly one brand, but the login behind it, and the OAuth grant that keeps it alive, is shared across all of them. This has two practical consequences:

Assigning Pages is explicit. Connecting a login does not attach every Page it can see to the brand you connected from. Each Page is assigned to a brand only when you select it, either during the connect flow’s pending-selection step or afterward through the endpoints below.
Re-authenticating refreshes everyone. When you or a teammate re-runs the OAuth flow for a login that already backs one or more brands, the refreshed token and Page grant apply to every brand using that login, not just the one you happened to reconnect from.

Managing Pages after connecting

Pages don’t have to be assigned at connect time. List a login’s current Pages, live from Meta, merged with which brand (if any) already owns each one:

curl "https://api.social-api.ai/v1/platforms/facebook/logins/{loginId}/pages" \
  -H "Authorization: Bearer $SOCAPI_KEY"

{
  "login_id": "cred_01J8X3Q4R5M6N7P8V2K0W1J",
  "pages": [
    {
      "platform_page_id": "17841400000000000",
      "name": "Acme Bakery",
      "assigned_brand_id": "",
      "assignable": true
    }
  ],
  "count": 1
}

Assign one unassigned Page to a brand:

curl -X POST "https://api.social-api.ai/v1/platforms/facebook/logins/{loginId}/pages/{pageId}/assign" \
  -H "Authorization: Bearer $SOCAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"brand_id": "b_01HZ9X3Q4R5M6N7P8V2K0W1J"}'

A Page already assigned to one of your brands cannot be assigned to a different one while it stays connected there. Trying to connect the same login into a brand whose Facebook account is already tied to a different login returns 409:

{
  "error": {
    "code": "account.different_login",
    "message": "This brand's Facebook is connected through a different login. Disconnect it first."
  }
}

Disconnect the brand’s existing Facebook account first if you intend to move it to a different login. Each brand can connect up to 5 Facebook Pages. This is a hard cap, the same on every plan, not a billed allowance: there is no per-page charge for staying under it, and no way to go over it. Assigning a 6th Page to a brand returns 403 platform.facebook.page_cap:

{
  "error": {
    "code": "platform.facebook.page_cap",
    "message": "Each brand can connect up to 5 Facebook Pages. Disconnect one or connect the rest to another brand."
  }
}

Reading samples

List posts

curl "https://api.social-api.ai/v1/accounts/{id}/posts?limit=10" \
  -H "Authorization: Bearer $SOCAPI_KEY"

Sample response:

{
  "data": [
    {
      "id": "123456789_987654321",
      "platform": "facebook",
      "caption": "Check out our new product!",
      "media_type": "status",
      "permalink": "https://www.facebook.com/123456789/posts/987654321",
      "timestamp": "2026-03-01T12:00:00Z",
      "like_count": 0,
      "comments_count": 0,
      "account_id": "acc_01HZ9X3Q4R5M6N7P8V2K0W1J"
    }
  ],
  "count": 1
}

List comments on a post

curl "https://api.social-api.ai/v1/accounts/{id}/posts/123456789_987654321/comments?limit=10" \
  -H "Authorization: Bearer $SOCAPI_KEY"

Sample response:

{
  "data": [
    {
      "id": "sapi_cmt_...",
      "platform": "facebook",
      "type": "comment",
      "author": {
        "id": "111222333",
        "name": "Jane Smith"
      },
      "content": {
        "text": "Great post!"
      },
      "metadata": {
        "post_id": "123456789_987654321",
        "hidden": false,
        "like_count": 2,
        "has_replies": true
      },
      "created_at": "2026-03-01T13:00:00Z",
      "account_id": "acc_01HZ9X3Q4R5M6N7P8V2K0W1J",
      "platform_id": "987654321_111222333"
    }
  ],
  "count": 1
}

List DMs

curl "https://api.social-api.ai/v1/accounts/{id}/dms?limit=10" \
  -H "Authorization: Bearer $SOCAPI_KEY"

Publishing

Create a Facebook Page post with optional platform-specific fields:

curl -X POST https://api.social-api.ai/v1/posts \
  -H "Authorization: Bearer $SOCAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Check out our new product!",
    "targets": [
      {
        "account_id": "acc_01HZ9X3Q4R5M6N7P8V2K0W1J",
        "platform_data": {
          "link": "https://example.com/product"
        }
      }
    ]
  }'

For the full field reference, media constraints, and error recovery, see Facebook posts.

Limitations and gotchas

Shared login, one Page per brand: a single OAuth flow surfaces every Page the login can manage, but each Page belongs to exactly one brand’s account_id, assigned explicitly during the pending-connection step or later. See One login, many brands.
Page tokens never expire: unlike Instagram, Facebook Page tokens derived from long-lived user tokens do not expire. No reconnection needed unless the user revokes access.
Private replies: replying to a comment with "private": true sends a one-time DM to the commenter. Can only be sent once per comment, within 7 days of the comment.
24-hour messaging window: Pages can send any message within 24 hours of the user’s last message. After that, only approved message tags are allowed. If you get an error sending a DM, the window may have closed.
Reviews deprecated: Facebook deprecated Page Recommendations/Reviews in Graph API v22.0 (January 2025). The API returns 501 for review endpoints.

Permissions

SocialAPI’s managed Meta App already requests these scopes on your behalf: pages_show_list, pages_read_engagement, pages_read_user_content, pages_manage_engagement, pages_manage_metadata, pages_messaging, pages_manage_posts, public_profile, business_management. You don’t need to apply for any platform app review. See Platform credentials.

​At a glance

​Capabilities

​Connecting

​One login, many brands

​Managing Pages after connecting

​Reading samples

​List posts

​List comments on a post

​List DMs

​Publishing

​Limitations and gotchas

​Permissions

​Related