All connectors
Facebook integration
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.
Connect Facebook to Xenition and work with it from chat, from an agent, or on a schedule — alongside every other app you have connected, in one workspace.
What you can do with Facebook
Ask in plain language and Xenition calls the right one:
- 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 action to work. Required permissions: business_management, pages_manage_metadata
- Create Comment — Creates a comment on a Facebook post or replies to an existing comment.
- 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 temporarily. This action publishes immediately and does not add photos to an existing a
- 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.
- 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-up operations, not the photo/media id alone.
- 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` format, required for FACEBOOK_GET_POST retrieval.
- 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.
- 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.
- 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.
- Get Comment — Retrieves details of a specific Facebook comment.
- 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 2025.
- Get Conversation Messages — Retrieves messages from a specific conversation.
- 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.
- Get Message Details — Retrieves details of a specific message sent or received by the Page.
- Get Page Conversations — Retrieves a list of conversations between users and the Page.
- Get Page Details — Fetches details about a specific Facebook Page.
- 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).
- 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.
- 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 the page (excludes scheduled/unpublished) The /feed endpoint provides the most c
- 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. Recently changed roles may take time to propagate; retry if role data appears stale
- 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.
- Get Page Videos — Retrieves videos from a Facebook Page.
- Get Post — Retrieves details of a specific Facebook post.
- 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.
- 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.
- 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 posts to avoid duplicates.
- Get User Pages (Deprecated) — 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 paginate ~100 items per page — follow `paging.cursors.after` or `next` until exhauste
- Add Reaction — 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.
- 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 Pages. Results are paginated via `paging.cursors`; follow `paging.next` until absent
- 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.
…and 14 more Facebook actions available in the workspace.
Give an agent access to Facebook
An agent you create can use Facebook on your behalf and keep working while you do something else. Every action an agent takes goes through an approval gate first, so nothing touches your Facebook account without you agreeing to it.
Other connectors
Frequently asked questions
How do I connect Facebook to Xenition?
Open the connectors directory in Xenition, find Facebook, and sign in when the authorisation window opens. The connection is managed for you — there is no API key to create, paste or rotate.
What can Xenition do with Facebook?
Xenition can run 44 different Facebook actions, including Assign Page Task, Create Comment, Create Multi-Photo Post. You ask in plain language and the right one is called for you.
Can an agent use Facebook on my behalf?
Yes. Agents can use Facebook while you do something else, and every action passes through an approval gate before it runs.
Is there a free plan?
Yes. Xenition starts free with 25,000 credits a month and no credit card, and all connectors are available on every plan.