Facebook for AI agents
Agents read Facebook at once. Changes and sends are held for a person's approval by default.
About 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.
What an agent can do in Facebook
Every Facebook action is classed by the platform as a read, a change or a send. Reads run at once. Changes and sends are held for a person by default.
Runs at once (reads)
Looks things up in Facebook without asking first. 29 actions.
- Get CommentsRetrieves 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 -
- Get Conversation MessagesRetrieves messages from a specific conversation.
- Get Page ConversationsRetrieves a list of conversations between users and the Page.
- Get Page PostsRetrieves 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 +
- Get Page Tagged PostsRetrieves 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.
- Get PostRetrieves details of a specific Facebook post.
- Get Ad InsightsRead Marketing API performance insights for an advertising object.
- Get CommentRetrieves details of a specific Facebook comment.
- Get Current UserValidates the access token and retrieves the authenticated user's own profile via /me. Cannot fetch arbitrary users by name or ID.
- Get Graph ObjectRead caller-selected fields from an identified Facebook Graph node using permissions already granted to the connection.
- Get Message DetailsRetrieves details of a specific message sent or received by the Page.
- Get Page DetailsFetches details about a specific Facebook Page.
Show all 29
- Get Page InsightsRetrieves 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 val
- Get Page PhotosRetrieves 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.
- Get Page RolesRetrieves 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 r
- Get Page VideosRetrieves videos from a Facebook Page.
- Get Post InsightsRetrieves 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
- Get Post ReactionsRetrieves 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.
- Get Scheduled PostsRetrieves 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 specifi
- List Ad AccountsList ad accounts available to the authenticated Facebook user.
- List AdsList ads associated with a Facebook advertising parent.
- List BusinessesList Business Manager businesses accessible to the connected Facebook user, including selected business details and permitted roles.
- List Client PagesList client-owned Pages accessible to a Business Manager business.
- List Managed PagesRetrieves 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;
- List Owned Ad AccountsList ad accounts owned by a Business Manager business, with optional Meta account filtering and cursor pagination.
- List Owned PagesList Facebook Pages owned by a Business Manager business.
- List PermissionsList granted, declined, or expired Facebook permissions for the connected user and app.
- List Video ThumbnailsList available thumbnail images for a Facebook video.
- Search Geographic Targeting LocationsFind current geographic keys accepted by Meta ad targeting.
Held for approval by default (changes and sends)
Held for a person's approval by default. The approval is recorded and the action is sent once, never twice, with 10 seconds to undo. 22 actions.
- Create CommentCreates a comment on a Facebook post or replies to an existing comment.
- Create Photo PostCreates 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
- Create PostCreates 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 po
- Create Video PostCreates 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.
- Send Media MessageSends a media message (image, video, audio, or file) from the Page to a user.
- Send MessageSends a text message from a Facebook Page (not personal profiles) to a user via Messenger. Requires explicit user confirmation before calling, as this action delivers a message to a real end user.
- Unlike Post or CommentRemoves a like from a Facebook post or comment.
- Upload Photos BatchUploads up to 50 independent photos to a Facebook Page or Album using the Graph batch API. With published=true, each page photo may create its own feed story; this action does not create one post cont
- Assign Page TaskAssigns tasks/roles to a business-scoped user or system user for a specific Facebook Page. The acting credential must be a Page access token requested by a person with the MANAGE task and the pages_ma
- Create Multi-Photo PostPublish 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 attac
- Delete CommentDeletes 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 authenti
- Delete PostPermanently 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.
Show all 22
- Add ReactionAdds 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 use
- Mark Message SeenMarks 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 poli
- Publish Scheduled PostPublishes a previously scheduled or unpublished Facebook post immediately. This action takes a scheduled or unpublished post and publishes it immediately by setting is_published to true. The post must
- Refresh URL ScrapeAsk Facebook to rescrape a public HTTP or HTTPS URL, optionally returning requested URL metadata fields.
- Remove Page TaskRemoves a user's tasks/access from a specific Facebook Page. Caller must have admin-level rights on the Page. Operates on one page_id at a time; repeat for each page if removing from multiple pages. P
- Reschedule PostChanges the scheduled publish time of an unpublished Facebook post. This action updates the scheduled_publish_time of a previously scheduled post. The post must have been created with published=false
- Toggle Typing IndicatorShows or hides the typing indicator for a user in Messenger.
- Update CommentUpdates an existing Facebook comment. IMPORTANT: This action requires a Page Access Token. The comment must belong to a post on a Page that you manage. Use the page_id parameter to ensure the correct
- Update Page SettingsUpdates settings for a specific Facebook Page. Requires the authenticated user to have MANAGE and CREATE_CONTENT tasks for the target page; verify roles via FACEBOOK_GET_PAGE_ROLES. Not all fields (ab
- Update PostUpdates an existing Facebook Page post.
Changes wait in Needs you
Changes and sends in Facebook are held for a person's approval by default. The approval is recorded, and the action is sent once, never twice, with 10 seconds to undo.
Facebook questions
Can an agent change data in Facebook on its own?
Not by default. Changes and sends in Facebook are held for a person's approval. The approval is recorded, and the action is sent once, never twice, with 10 seconds to undo.
What can an agent read in Facebook?
This connector lists 29 read actions. Reads run at once, without waiting for approval.
How does Facebook connect?
It connects with OAuth 2.0. Connectors are built and maintained by third-party developers; availability is confirmed during scoping.