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.
ActionTry it
Integrate Facebook
with your AI CRM
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.
Explore Triggers and Actions
Assign Page Task
Assigns 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.
ActionTry it
Create Comment
Creates a comment on a Facebook post or replies to an existing comment.
ActionTry it
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 album.
ActionTry it
Create Photo Post
Creates 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.
ActionTry it
Create Post
Creates 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.
ActionTry it
Create Video Post
Creates 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.
ActionTry it
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.
ActionTry it
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.
ActionTry it
Get Ad Insights
Read Marketing API performance insights for an advertising object.
ActionTry it
Get Comment
Retrieves details of a specific Facebook comment.
ActionTry it
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 v26.0, released July 2026.
ActionTry it
Get Conversation Messages
Retrieves messages from a specific conversation.
ActionTry it
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.
ActionTry it
Get Graph Object
Read caller-selected fields from an identified Facebook Graph node using permissions already granted to the connection.
ActionTry it
Get Graph Objects
Read caller-selected fields from multiple Facebook Graph nodes in one batch request and return successes and failures keyed by requested object ID.
ActionTry it
Get Message Details
Retrieves details of a specific message sent or received by the Page.
ActionTry it
Get Page Conversations
Retrieves a list of conversations between users and the Page.
ActionTry it
Get Page Details
Fetches details about a specific Facebook Page.
ActionTry it
Get Page Insights
Retrieves 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.
ActionTry it
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.
ActionTry it
Get Page Posts
Retrieves 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.
ActionTry it
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 after an update.
ActionTry it
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.
ActionTry it
Get Page Videos
Retrieves videos from a Facebook Page.
ActionTry it
Get Post
Retrieves details of a specific Facebook post using a full numeric Page ID and post ID separated by an underscore.
ActionTry it
Get Post Insights
Retrieves 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.
ActionTry it
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.
ActionTry it
Get Scheduled Posts
Retrieves one page of scheduled and unpublished posts for a Facebook Page, with pagination information when returned. The request supports a result limit and selected fields.
ActionTry it
Get User Pages (Deprecated)
Retrieves Facebook Pages accessible to a user, defaulting to the current user. This deprecated action requires the pages_show_list scope and supports cursor pagination.
ActionTry it
List Ad Account Campaigns
List campaigns belonging to a Facebook ad account.
ActionTry it
List Ad Accounts
List ad accounts available to the authenticated Facebook user.
ActionTry it
List Ads
List ads associated with a Facebook advertising parent.
ActionTry it
List Assigned Ad Accounts
Lists 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.
ActionTry it
List Business Ad Accounts
Lists 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.
ActionTry it
List Businesses
List Business Manager businesses accessible to the connected Facebook user, including selected business details and permitted roles.
ActionTry it
List Client Pages
List client-owned Pages accessible to a Business Manager business.
ActionTry it
List Managed Pages
Retrieves 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.
ActionTry it
List Object Attachments
List one page of attachments belonging to a Facebook Graph object.
ActionTry it
List Owned Ad Accounts
List ad accounts owned by a Business Manager business, with optional Meta account filtering and cursor pagination.
ActionTry it
List Owned Pages
List Facebook Pages owned by a Business Manager business.
ActionTry it
List Page Ads Posts
List ad-created Page posts, including optional inline-created and dynamic-ad filters. The connected account must have the ADVERTISE task for the Page.
ActionTry it
List Page Albums
List photo albums belonging to a managed Facebook Page with selected fields and safe cursor pagination.
ActionTry it
List Page Events
List events associated with a managed Facebook Page.
ActionTry it
List Page Leadgen Forms
List lead-generation forms owned by a managed Facebook Page. The Page role must include access to leads. Requires the pages_manage_ads (or leads_retrieval) OAuth scope, which is not granted by default; add it via optional scopes.
ActionTry it
List Page Reels
List a Facebook Page's Reel video records with selected fields and cursor pagination.
ActionTry it
List Page Stories
Lists 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.
ActionTry it
List Page Subscribed Apps
List applications subscribed to webhook notifications for a Facebook Page managed by the connected account.
ActionTry it
List Page-Authored Posts
List posts authored by a Facebook Page, excluding visitor and tagged feed content.
ActionTry it
List Permissions
List granted, declined, or expired Facebook permissions for the connected user and app.
ActionTry it
List Published Page Posts
List posts published by a Facebook Page, excluding unpublished posts.
ActionTry it
List Video Captions
List one page of caption tracks attached to a managed Page's video.
ActionTry it
List Video Tags
Return one page of people or Pages tagged on a Facebook video.
ActionTry it
List Video Thumbnails
List available thumbnail images for a Facebook video.
ActionTry it
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.
ActionTry it
Publish Page Photo Story
Publish an existing unpublished Facebook Page photo as a Page Story. The photo must already belong to the requested managed Page. The Story is published publicly on the Page immediately and is visible to its audience.
ActionTry it
Publish Page Reel
Create a Facebook Page Reel from a hosted or local video and finish it as a draft, scheduled Reel, or publicly published Reel according to video_state.
ActionTry it
Publish Scheduled Post
Publishes 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 permission
ActionTry it
Refresh URL Scrape
Ask Facebook to rescrape a public HTTP or HTTPS URL, optionally returning requested URL metadata fields.
ActionTry it
Remove Page Task
Removes 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.
ActionTry it
Reschedule Post
Changes 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.
ActionTry it
Search Ad Targeting Options
Searches 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.
ActionTry it
Search Geographic Targeting Locations
Find current geographic keys accepted by Meta ad targeting.
ActionTry it
Search Pages
Searches 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.
ActionTry it
Send Media Message
Sends a media message (image, video, audio, or file) from the Page to a user.
ActionTry it
Send Message
Sends 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.
ActionTry it
Set Page Profile Picture
Replace a managed Facebook Page's profile picture with an image fetched from a public HTTP or HTTPS URL.
ActionTry it
Set Video Thumbnail
Upload a thumbnail image for a video owned by a managed Facebook Page and optionally make it preferred.
ActionTry it
Toggle Typing Indicator
Shows or hides the typing indicator for a user in Messenger.
ActionTry it
Unlike Post or Comment
Removes a like from a Facebook post or comment.
ActionTry it
Update Comment
Updates 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.
ActionTry it
Update Page Settings
Updates 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.
ActionTry it
Update Post
Updates an existing Facebook Page post.
ActionTry it
Upload Photo
DEPRECATED: Use FACEBOOK_CREATE_PHOTO_POST instead. Uploads a photo file directly to a Facebook Page. Supports local file upload up to 10MB.
ActionTry it
Upload Photos Batch
Uploads 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.
ActionTry it
Upload Video (Deprecated)
DEPRECATED: 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.
ActionTry it
How the Facebook integration works
The Facebook integration connects your Dench AI CRM directly to Facebook, so agents can read and act on your Facebook data as part of everyday work — answering questions in chat, keeping your CRM in sync, and running automations without anyone copying data between tools.
76 actions are available for agents to invoke on your behalf. Every call runs through Facebook's own authorization, scoped to the account you connect.
Set up Facebook in Dench
- 1
Sign in to your Dench workspace and open Integrations.
- 2
Find Facebook and click Connect — you'll authorize access through Facebook's own sign-in flow. No API keys or code required.
- 3
Ask an agent to use Facebook in chat, or call it from an automation.
- 4
Manage or disconnect the connection any time from workspace settings.
Frequently asked questions
How does the Facebook integration work with Dench?
The Dench Facebook integration connects your AI CRM to Facebook, so AI agents can work with your Facebook data as part of chats, automations, and CRM workflows. You connect your account once, and every agent in your workspace can use it — governed by your workspace permissions.
What actions can AI agents perform with Facebook via Dench?
The Facebook integration currently exposes 76 actions, including Add Reaction, Assign Page Task, Create Comment, Create Multi-Photo Post, Create Photo Post, and Create Post. Agents invoke them on your behalf from chat or from automations.
Do I need to write code to connect Facebook to Dench?
No. You connect Facebook from your Dench workspace using Facebook's own sign-in and authorization flow — no API keys to copy, no glue code to maintain.
Is the Facebook integration secure?
Connections are authorized through Facebook's own authentication flow, and Dench stores only the authorization needed to act on your behalf. You can review and disconnect the Facebook connection from your workspace settings at any time.