- Category: social media accounts
- Auth: OAUTH2
- Composio-managed OAuth available? Yes
- Tools: 64
- Triggers: 0
- Slug:
FACEBOOK - Version: 20261103_00
Frequently Asked Questions
How do I set up custom OAuth credentials for Meta (Facebook)?
How do I set up custom OAuth credentials for Meta (Facebook)?
Tools
Assign Page Task
Assign Page Task
FACEBOOK_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_manage_metadata permission. The target user must be a business-scoped user ID or system user ID; regular Facebook user IDs are not accepted.Input Parameters
Output
Create Comment
Create Comment
FACEBOOK_CREATE_COMMENTCreates a comment on a Facebook post or replies to an existing comment.Input Parameters
Output
Create Multi-Photo Post
Create Multi-Photo Post
FACEBOOK_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 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 album.Input Parameters
Output
Create Photo Post
Create Photo Post
FACEBOOK_CREATE_PHOTO_POSTCreates a photo post on a Facebook Page using an image URL or uploaded image, with an optional caption. Returns a photo ID and may also return a composite post ID for follow-up post operations.Input Parameters
Output
Create Post
Create Post
FACEBOOK_CREATE_POSTCreates a text or link post on a Facebook Page, with a required message field and optional link, scheduling, and targeting. Requires pages_manage_posts permission and a manage-level Page role; returns a post ID.Input Parameters
message or link must be non-empty; omitting both causes a validation error.Output
Create Video Post
Create Video Post
FACEBOOK_CREATE_VIDEO_POSTCreates a video post on a Facebook Page. Local files use Facebook’s resumable upload protocol, including large videos. Requires a Page access token with pages_manage_posts scope and manage-level permissions on the target page.Input Parameters
published=false; must be a UTC Unix epoch at least ~10 minutes in the future. Combining with published=true or omitting when published=false causes 400 errors.Output
Delete Comment
Delete Comment
FACEBOOK_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 authentication.Input Parameters
Output
Delete Post
Delete Post
FACEBOOK_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.Input Parameters
Output
Get Ad Insights
Get Ad Insights
FACEBOOK_GET_AD_INSIGHTSRead Marketing API performance insights for an advertising object.Input Parameters
Output
Get Comment
Get Comment
Get Comments
Get Comments
FACEBOOK_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 - The API automatically swaps user tokens for page tokens when available API Version: Uses v26.0, released July 2026.Input Parameters
Output
Get Conversation Messages
Get Conversation Messages
FACEBOOK_GET_CONVERSATION_MESSAGESRetrieves messages from a specific conversation.Input Parameters
paging.cursors.after or the next URL from the response.Output
Get Current User
Get Current User
FACEBOOK_GET_CURRENT_USERValidates the access token and retrieves the authenticated user’s own profile via /me. Cannot fetch arbitrary users by name or ID.Input Parameters
email. Handle missing fields defensively.Output
Get Graph Object
Get Graph Object
FACEBOOK_GET_GRAPH_OBJECTRead caller-selected fields from an identified Facebook Graph node using permissions already granted to the connection.Input Parameters
Output
Get Graph Objects
Get Graph Objects
FACEBOOK_GET_GRAPH_OBJECTSRead caller-selected fields from multiple Facebook Graph nodes in one batch request and return successes and failures keyed by requested object ID.Input Parameters
Output
Get Message Details
Get Message Details
Get Page Conversations
Get Page Conversations
FACEBOOK_GET_PAGE_CONVERSATIONSRetrieves a list of conversations between users and the Page.Input Parameters
paging.cursors.after or paging.next from the response to paginate beyond the first page.Output
Get Page Details
Get Page Details
FACEBOOK_GET_PAGE_DETAILSFetches details about a specific Facebook Page.Input Parameters
Output
Get Page Insights
Get Page Insights
FACEBOOK_GET_PAGE_INSIGHTSRetrieves analytics and insights for a Facebook Page, including follower, media view and engagement metrics. Some requested legacy metrics are replaced with different supported metrics, while unsupported metrics may be removed or rejected; check the returned metric names and execution message.Input Parameters
lifetime with bounded since/until ranges produces misleading or empty results. Standardize all date inputs to UTC.Output
Get Page Photos
Get Page Photos
FACEBOOK_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.Input Parameters
Output
Get Page Posts
Get Page Posts
FACEBOOK_GET_PAGE_POSTSRetrieves posts from a Facebook Page’s feed using Graph API v26.0, with optional time filters. The response may include pagination information, but this tool does not accept a cursor or next URL for subsequent pages.Input Parameters
Output
Get Page Roles
Get Page Roles
FACEBOOK_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 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 after an update.Input Parameters
Output
Get Page Tagged Posts
Get Page Tagged Posts
FACEBOOK_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.Input Parameters
Output
Get Page Videos
Get Page Videos
FACEBOOK_GET_PAGE_VIDEOSRetrieves videos from a Facebook Page.Input Parameters
paging.cursors.after) until no next page is returned to retrieve all videos.source field returns time-limited URLs; download or process promptly rather than storing for later use.Output
Get Post
Get Post
FACEBOOK_GET_POSTRetrieves details of a specific Facebook post using a full numeric Page ID and post ID separated by an underscore.Input Parameters
Output
Get Post Insights
Get Post Insights
FACEBOOK_GET_POST_INSIGHTSRetrieves media-view and unique media-viewer insights for a Facebook post. Some legacy metric names are mapped to these metrics, while certain removed metrics are rejected.Input Parameters
Output
Get Post Reactions
Get Post Reactions
Get Scheduled Posts
Get Scheduled Posts
Get User Pages (Deprecated)
Get User Pages (Deprecated)
FACEBOOK_GET_USER_PAGESRetrieves Facebook Pages accessible to a user, defaulting to the current user. This deprecated action requires the pages_show_list scope and supports cursor pagination.Input Parameters
id and name to avoid extra identity-resolution calls. Check tasks values before write actions — Page inclusion does not guarantee publish/manage permissions.Output
Add Reaction
Add Reaction
FACEBOOK_LIKE_POST_OR_COMMENTAdds 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.Input Parameters
Output
List Ad Account Campaigns
List Ad Account Campaigns
FACEBOOK_LIST_AD_ACCOUNT_CAMPAIGNSList campaigns belonging to a Facebook ad account.Input Parameters
Output
List Ad Accounts
List Ad Accounts
List Ads
List Ads
List Assigned Ad Accounts
List Assigned Ad Accounts
FACEBOOK_LIST_ASSIGNED_AD_ACCOUNTSLists ad accounts assigned to a business-scoped user. Use a Business User ID, not a Facebook user ID or Business ID. Results use cursor pagination; pass paging.cursors.after to retrieve the next page.Input Parameters
Output
List Business Ad Accounts
List Business Ad Accounts
FACEBOOK_LIST_BUSINESS_AD_ACCOUNTSLists client ad accounts a Facebook Business can access. Calls GET /{business_id}/client_ad_accounts, which returns ad accounts owned by other businesses that have been shared with this business. To list ad accounts owned by the business itself, use FACEBOOK_LIST_OWNED_AD_ACCOUNTS.Input Parameters
Output
List Businesses
List Businesses
List Client Pages
List Client Pages
List Managed Pages
List Managed Pages
FACEBOOK_LIST_MANAGED_PAGESRetrieves Facebook Pages managed by a user, with page details, access tokens and tasks when returned. Results are paginated using cursors; an empty result alone does not establish why no Pages were returned.Input Parameters
Output
List Object Attachments
List Object Attachments
List Owned Ad Accounts
List Owned Ad Accounts
List Owned Pages
List Owned Pages
List Page Stories
List Page Stories
FACEBOOK_LIST_PAGE_STORIESLists photo and video stories for a Facebook Page managed by the connected account. The Page must have an available Page access token; results can be filtered by status and creation time and paginated with cursors.Input Parameters
Output
List Permissions
List Permissions
List Published Page Posts
List Published Page Posts
FACEBOOK_LIST_PUBLISHED_PAGE_POSTSList posts published by a Facebook Page, excluding unpublished posts.Input Parameters
Output
List Video Thumbnails
List Video Thumbnails
Mark Message Seen
Mark Message Seen
FACEBOOK_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 policy requires that users have messaged the Page within the last 24 hours for sender actions to work.Input Parameters
Output
Publish Scheduled Post
Publish Scheduled Post
FACEBOOK_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 have been previously created with published=false or with a scheduled_publish_time. Requirements: - The post must exist and be in an unpublished/scheduled state - The user must have admin access to the page that owns the post - The app must have pages_manage_posts permissionInput Parameters
Output
Refresh URL Scrape
Refresh URL Scrape
Remove Page Task
Remove Page Task
FACEBOOK_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. Partial access may remain if only some tasks are revoked.Input Parameters
Output
Reschedule Post
Reschedule Post
FACEBOOK_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 and a scheduled_publish_time.Input Parameters
Output
Search Ad Targeting Options
Search Ad Targeting Options
FACEBOOK_SEARCH_AD_TARGETING_OPTIONSSearches query-driven Meta ad targeting option families, including geographic areas, interests, locales, schools, majors, employers, and job titles. Results vary by search type, so inspect each returned object’s fields. Pass paging.cursors.after to retrieve the next page.Input Parameters
q parameter. Use an empty string to list all countries, regions, or locales when supported.Output
Search Geographic Targeting Locations
Search Geographic Targeting Locations
Search Pages
Search Pages
FACEBOOK_SEARCH_PAGESSearches for Facebook Pages based on a query string. Returns pages matching the search criteria with requested fields. Requires pages_read_engagement. The Meta app must also have Page Public Metadata Access for public Page information or Page Public Content Access for competitive-analysis use cases. These are app-level features, not OAuth scopes. Missing feature access is returned as Meta error 10 and fails the execution. Results include only Pages, not profiles, groups, or other entities.Input Parameters
Output
Send Media Message
Send Media Message
Send Message
Send Message
FACEBOOK_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.Input Parameters
Output
Toggle Typing Indicator
Toggle Typing Indicator
Unlike Post or Comment
Unlike Post or Comment
FACEBOOK_UNLIKE_POST_OR_COMMENTRemoves a like from a Facebook post or comment.Input Parameters
Output
Update Comment
Update Comment
FACEBOOK_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 page token is used, especially if you manage multiple pages.Input Parameters
Output
Update Page Settings
Update Page Settings
FACEBOOK_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 (about, description, general_info, etc.) are available for every Page category.Input Parameters
Output
Upload Photo
Upload Photo
FACEBOOK_UPLOAD_PHOTODEPRECATED: Use FACEBOOK_CREATE_PHOTO_POST instead. Uploads a photo file directly to a Facebook Page. Supports local file upload up to 10MB.Input Parameters
published=false; value must be a future UTC epoch in seconds. Using published=true with this field causes validation errors.Output
Upload Photos Batch
Upload Photos Batch
FACEBOOK_UPLOAD_PHOTOS_BATCHUploads independent photos to a Facebook Page or Album using the Graph batch API, accepting up to 50 local files and up to 50 photo URLs. Published Page photos may each create their own feed story rather than one multi-photo post.Input Parameters
scheduled_publish_time as a Unix UTC epoch timestamp; mismatched combinations trigger 400 errors.Output
Upload Video (Deprecated)
Upload Video (Deprecated)
FACEBOOK_UPLOAD_VIDEODEPRECATED: Use CreateVideoPost instead. Uploads a video file directly to a Facebook Page. Supports local file upload. For large videos (>100MB), uses resumable upload. After upload completes, the video enters a processing/pending state; do not reference or schedule it until processing finishes.Input Parameters
published=false; combining with published=true triggers a 400 validation error.