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. facebook · 43 tools · no triggers

Connect it

run auth facebook
run auth facebook --scope team    # shared with the organization

Or from the Integrations page in the console. See Connections for personal versus shared, and who may remove one.

Use it

run facebook          # common commands
run facebook --all    # every command

import { facebook } from "@boxd/run";

Common tools

Tool	What it does
`create-comment`	Creates a comment on a Facebook post or replies to an existing comment.
`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…
`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).
`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.
`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.
`get-comments`	Retrieves comments from a Facebook post or comment (for replies).
`get-conversation-messages`	Retrieves messages from a specific conversation.
`get-page-conversations`	Retrieves a list of conversations between users and the Page.
`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…
`get-page-tagged-posts`	Retrieves posts where a Facebook Page is tagged or mentioned.
`get-post`	Retrieves details of a specific Facebook post.
`search-pages`	Searches for Facebook Pages based on a query string. Returns pages matching the search criteria with requested fields.
`send-media-message`	Sends a media message (image, video, audio, or file) from the Page to a user.
`send-message`	Sends a text message from a Facebook Page (not personal profiles) to a user via Messenger.
`unlike-post-or-comment`	Removes a like from a Facebook post or comment.
`upload-photo`	DEPRECATED: Use FACEBOOK_CREATE_PHOTO_POST instead. Uploads a photo file directly to a Facebook Page.
`upload-photos-batch`	Uploads multiple photo files in batch to a Facebook Page or Album.
`upload-video`	DEPRECATED: Use CreateVideoPost instead. Uploads a video file directly to a Facebook Page.

All 43 tools

Tool	What it does
`assign-page-task`	Assigns tasks/roles to a business-scoped user or system user for a specific Facebook Page.
`create-comment`	Creates a comment on a Facebook post or replies to an existing comment.
`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…
`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).
`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.
`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.
`delete-post`	Permanently deletes a Facebook Page post. Deletion is irreversible - deleted posts cannot be recovered.
`get-comment`	Retrieves details of a specific Facebook comment.
`get-comments`	Retrieves comments from a Facebook post or comment (for replies).
`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.
`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.
`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…
`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…
`get-page-roles`	Retrieves a list of people and their tasks/roles on a Facebook Page.
`get-page-tagged-posts`	Retrieves posts where a Facebook Page is tagged or mentioned.
`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.
`get-post-reactions`	Retrieves reactions (like, love, wow, etc.) for a Facebook post.
`get-scheduled-posts`	Retrieves scheduled and unpublished posts for a Facebook Page.
`get-user-pages`	DEPRECATED: Use FACEBOOK_LIST_MANAGED_PAGES instead. Retrieves Facebook Pages the user manages (excludes personal profiles, groups, and non-Page…
`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.
`list-managed-pages`	Retrieves a list of Facebook Pages that the user manages (not personal profiles), including page details, access tokens, and tasks.
`mark-message-seen`	Marks a user’s message as seen by the Page, visibly updating the read status in the user’s conversation.
`publish-scheduled-post`	Publishes a previously scheduled or unpublished Facebook post immediately.
`remove-page-task`	Removes a user’s tasks/access from a specific Facebook Page.
`reschedule-post`	Changes the scheduled publish time of an unpublished Facebook post.
`search-pages`	Searches for Facebook Pages based on a query string. Returns pages matching the search criteria with requested fields.
`send-media-message`	Sends a media message (image, video, audio, or file) from the Page to a user.
`send-message`	Sends a text message from a Facebook Page (not personal profiles) to a user via Messenger.
`toggle-typing-indicator`	Shows or hides the typing indicator for a user in Messenger.
`unlike-post-or-comment`	Removes a like from a Facebook post or comment.
`update-comment`	Updates an existing Facebook comment. IMPORTANT: This action requires a Page Access Token.
`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…
`update-post`	Updates an existing Facebook Page post.
`upload-photo`	DEPRECATED: Use FACEBOOK_CREATE_PHOTO_POST instead. Uploads a photo file directly to a Facebook Page.
`upload-photos-batch`	Uploads multiple photo files in batch to a Facebook Page or Album.
`upload-video`	DEPRECATED: Use CreateVideoPost instead. Uploads a video file directly to a Facebook Page.

Open Facebook in the console →

Getting started

Guides

Integrations & automations

Use cases

References

Connect it

Use it

Common tools

​Connect it

​Use it

​Common tools

Connect it

Use it

Common tools