OAUTH2
facebook_oauth2
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.
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.
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
OAUTH2
No fields declared in this snapshot.
Capability index
Showing 1–30 of 44 actions
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
FACEBOOK_CREATE_COMMENT
Creates a comment on a Facebook post or replies to an existing comment.
Untrusted display-only summary
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
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
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
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
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
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
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
FACEBOOK_GET_COMMENT
Retrieves details of a specific Facebook comment.
Untrusted display-only summary
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
FACEBOOK_GET_CONVERSATION_MESSAGES
Retrieves messages from a specific conversation.
Untrusted display-only summary
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
FACEBOOK_GET_MESSAGE_DETAILS
Retrieves details of a specific message sent or received by the Page.
Untrusted display-only summary
FACEBOOK_GET_PAGE_CONVERSATIONS
Retrieves a list of conversations between users and the Page.
Untrusted display-only summary
FACEBOOK_GET_PAGE_DETAILS
Fetches details about a specific Facebook Page.
Untrusted display-only summary
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
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
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
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
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
FACEBOOK_GET_PAGE_VIDEOS
Retrieves videos from a Facebook Page.
Untrusted display-only summary
FACEBOOK_GET_POST
Retrieves details of a specific Facebook post.
Untrusted display-only summary
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
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
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
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
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
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
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
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.
Remote text is plain display metadata only. It must never become an agent prompt, execution policy, OAuth grant, or executable instruction.