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 and redirects the user to your redirect_uri with the connection result. See OAuth flows for the redirect parameters.

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

Multi-Page OAuth: a single OAuth flow connects all Facebook Pages the user manages. Each Page gets its own account_id.
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

​Reading samples

​List posts

​List comments on a post

​List DMs

​Publishing

​Limitations and gotchas

​Permissions

​Related