All integrations
Catalogue metadata onlysocial media accountsv20260902_00

FACEBOOK

Facebook

Facebook is a social media and advertising platform used by individuals and businesses to connect, share content, and promote products or services. Only supports Facebook Pages, not Facebook Personal accounts.

Description is untrusted, display-only upstream metadata. It never becomes policy, OAuth scope authority, or an agent instruction.

Pakkawork boundary

Research catalogue metadata only. No Pakkawork OAuth, credential, host, quota, executor, or verifier is enabled.

No Pakkawork execution adapter is enabled. Hosted account-authorisation availability is workspace-specific and checked separately in the dashboard.Check workspace connection options
Attributed source

44

Action summaries

Display-only definitions

0

Trigger types

Not installed instances

1

Auth modes

Field names, never values

No

Execution

No runtime adapter

Authentication map

What setup is declared?

Only field names, types, and required markers are shown. Secret values, default auth URLs, credential material, and inferred OAuth scopes are excluded.
OAUTH2 · managed upstream

OAUTH2

facebook_oauth2

Upstream managed

Developer setup

  • Client idclient_id · stringRequired
  • Client secretclient_secret · stringRequired
  • Redirect URIoauth_redirect_uri · stringOptional
  • Scopesscopes · stringOptional

User connection

No fields declared in this snapshot.

Capability index

Actions and trigger definitions

Static summaries are available. Live schemas remain disabled until PROVIDER_HUB_API_KEY is configured server-side.

Showing 1–30 of 44 actions

Assign Page Task

FACEBOOK_ASSIGN_PAGE_TASK

Assigns tasks/roles to a business-scoped user or system user for a specific Facebook Page. Important: This action requires a business-scoped user ID or system user ID from Facebook Business Manager. Regular Facebook user IDs cannot be used. The page must also be managed through Facebook Business Manager for this actio…

Untrusted display-only summary

Create Comment

FACEBOOK_CREATE_COMMENT

Creates a comment on a Facebook post or replies to an existing comment.

Untrusted display-only summary

Create Multi-Photo Post

FACEBOOK_CREATE_MULTI_PHOTO_POST

Publish one Facebook Page feed post containing one or more photos from public URLs. The action first uploads every photo with published=false, then creates one /feed post with those photo IDs as attached_media. If any upload fails, the feed post is not created; earlier uploads can remain unpublished on Facebook tempor…

Untrusted display-only summary

Create Photo Album

FACEBOOK_CREATE_PHOTO_ALBUM

Creates a new photo album on a Facebook Page. Note: This endpoint requires the 'pages_manage_posts' permission or equivalent permissions to be granted to your Facebook application. This action is publicly visible on the Page; confirm with the user before calling.

Untrusted display-only summary

Create Photo Post

FACEBOOK_CREATE_PHOTO_POST

Creates a photo post on a Facebook Page. Requires an image to be provided via either 'url' (publicly accessible image URL) or 'photo' (local image file upload). This action is specifically for posting images with optional captions, not text-only posts. Returns a composite post_id (PageID_PostID); use this for follow-u…

Untrusted display-only summary

Create Post

FACEBOOK_CREATE_POST

Creates a new text or link post on a Facebook Page. Requires `pages_manage_posts` permission and manage-level Page role on the target Page. For image posts use FACEBOOK_CREATE_PHOTO_POST; for video posts use FACEBOOK_CREATE_VIDEO_POST — media fields are not supported here. Returns a composite post ID in `PageID_PostID…

Untrusted display-only summary

Create Video Post

FACEBOOK_CREATE_VIDEO_POST

Creates a video post on a Facebook Page. Requires a Page access token with `pages_manage_posts` scope and manage-level permissions on the target page.

Untrusted display-only summary

Delete Comment

FACEBOOK_DELETE_COMMENT

Deletes a Facebook comment. Requires a Page Access Token with appropriate permissions for comments on Page-owned content. The page_id parameter helps ensure the correct page token is used for authentication.

Untrusted display-only summary

Delete Post

FACEBOOK_DELETE_POST

Permanently deletes a Facebook Page post. Deletion is irreversible — deleted posts cannot be recovered. For bulk deletions, keep throughput to ~1 delete/second to avoid Graph API rate limits.

Untrusted display-only summary

Get Comment

FACEBOOK_GET_COMMENT

Retrieves details of a specific Facebook comment.

Untrusted display-only summary

Get Comments

FACEBOOK_GET_COMMENTS

Retrieves comments from a Facebook post or comment (for replies). This endpoint requires appropriate permissions: - For page-owned posts: A Page Access Token with 'pages_read_engagement' permission - The API automatically swaps user tokens for page tokens when available API Version: Uses v23.0 which was released May 2…

Untrusted display-only summary

Get Conversation Messages

FACEBOOK_GET_CONVERSATION_MESSAGES

Retrieves messages from a specific conversation.

Untrusted display-only summary

Get Current User

FACEBOOK_GET_CURRENT_USER

Validates the access token and retrieves the authenticated user's own profile via /me. Cannot fetch arbitrary users by name or ID.

Untrusted display-only summary

Get Message Details

FACEBOOK_GET_MESSAGE_DETAILS

Retrieves details of a specific message sent or received by the Page.

Untrusted display-only summary

Get Page Conversations

FACEBOOK_GET_PAGE_CONVERSATIONS

Retrieves a list of conversations between users and the Page.

Untrusted display-only summary

Get Page Details

FACEBOOK_GET_PAGE_DETAILS

Fetches details about a specific Facebook Page.

Untrusted display-only summary

Get Page Insights

FACEBOOK_GET_PAGE_INSIGHTS

Retrieves analytics and insights for a Facebook Page. Returns metrics like impressions, page views, fan counts, and engagement data. Empty objects (`{}`) in results indicate missing data, not zero values. High-volume calls risk Graph API rate limits (error codes 4/613).

Untrusted display-only summary

Get Page Photos

FACEBOOK_GET_PAGE_PHOTOS

Retrieves photos from a Facebook Page. CDN-based URLs (including `source`) are time-limited and expire; download and persist images promptly if long-term access is needed.

Untrusted display-only summary

Get Page Posts

FACEBOOK_GET_PAGE_POSTS

Retrieves posts from a Facebook Page. Endpoint choice: Uses /{page_id}/feed instead of /posts or /published_posts because: - /feed returns all content on page timeline (page's posts + visitor posts + tagged posts) - /posts returns only posts created by the page itself - /published_posts returns only published posts by…

Untrusted display-only summary

Get Page Roles

FACEBOOK_GET_PAGE_ROLES

Retrieves a list of people and their tasks/roles on a Facebook Page. The connected account must have management access to the target Page; otherwise the response may be empty or incomplete. Returned role types include MANAGE and CREATE_CONTENT — verify these before calling tools like FACEBOOK_UPDATE_PAGE_SETTINGS. Rec…

Untrusted display-only summary

Get Page Tagged Posts

FACEBOOK_GET_PAGE_TAGGED_POSTS

Retrieves posts where a Facebook Page is tagged or mentioned. Use when monitoring brand mentions or tracking posts that tag your Page but don't appear on your Page's own feed.

Untrusted display-only summary

Get Page Videos

FACEBOOK_GET_PAGE_VIDEOS

Retrieves videos from a Facebook Page.

Untrusted display-only summary

Get Post

FACEBOOK_GET_POST

Retrieves details of a specific Facebook post.

Untrusted display-only summary

Get Post Insights

FACEBOOK_GET_POST_INSIGHTS

Retrieves analytics and insights for a specific Facebook post. Returns metrics like impressions, clicks, and engagement data. Very new posts may return empty metric values; allow a short delay before querying and treat absent fields as partial data.

Untrusted display-only summary

Get Post Reactions

FACEBOOK_GET_POST_REACTIONS

Retrieves reactions (like, love, wow, etc.) for a Facebook post. Very recent posts may return empty or partial reactions data; treat missing fields as incomplete coverage, not an error.

Untrusted display-only summary

Get Scheduled Posts

FACEBOOK_GET_SCHEDULED_POSTS

Retrieves scheduled and unpublished posts for a Facebook Page. Results are cursor-paginated; follow pagination cursors to retrieve all results beyond the limit. When searching for posts near a specific time, filter to a narrow (~±5 minutes) window. Use this tool to check for existing entries before scheduling new post…

Untrusted display-only summary

Get User Pages (Deprecated)

FACEBOOK_GET_USER_PAGES

DEPRECATED: Use FACEBOOK_LIST_MANAGED_PAGES instead. Retrieves Facebook Pages the user manages (excludes personal profiles, groups, and non-Page entities); an empty `data` array means no manageable Pages exist. Requires `pages_show_list` scope; missing scopes yield empty `data` or OAuthException code 200. Results pagi…

Untrusted display-only summary

Add Reaction

FACEBOOK_LIKE_POST_OR_COMMENT

Adds a LIKE reaction to a Facebook post or comment. Note: Due to API limitations, only LIKE reactions can be added programmatically. This action is user-visible and irreversible — confirm with the user before calling.

Untrusted display-only summary

List Managed Pages

FACEBOOK_LIST_MANAGED_PAGES

Retrieves a list of Facebook Pages that the user manages (not personal profiles), including page details, access tokens, and tasks. Requires `pages_show_list` or `pages_read_engagement` OAuth scopes; missing scopes silently return empty results rather than an error. An empty `data` array means the user manages no Page…

Untrusted display-only summary

Mark Message Seen

FACEBOOK_MARK_MESSAGE_SEEN

Marks a user's message as seen by the Page, visibly updating the read status in the user's conversation. Note: This action requires an active messaging session with the user. Facebook's messaging policy requires that users have messaged the Page within the last 24 hours for sender actions to work.

Untrusted display-only summary

Provenance

Versioned facts, explicit trust.

The detail snapshot comes from an attributed MIT-licensed repository revision. Safe local icons use exact-match CC0 Simple Icons symbols; unmatched brands use monograms.

Repository
https://github.com/provider-directoryHQ/provider-directory
Commit
85e33f6a81dfe987f6fc3637d48d45052cea8ca5
Generated
2026-09-12
Trust policy
untrusted_display_only

Remote text is plain display metadata only. It must never become an agent prompt, execution policy, OAuth grant, or executable instruction.