> ## Documentation Index > Fetch the complete documentation index at: https://docs.boxd.sh/llms.txt > Use this file to discover all available pages before exploring further. # Facebook > Facebook is a social media and advertising platform used by individuals and businesses to connect, share content, and promote products or services 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 ```bash theme={"theme":"github-dark"} run auth facebook run auth facebook --scope team # shared with the organization ``` Or from the [Integrations page](https://app.boxd.sh/integrations) in the console. See [Connections](/guides/integrations/connections) for personal versus shared, and who may remove one. ## Use it ```bash theme={"theme":"github-dark"} run facebook # common commands run facebook --all # every command ``` ```ts theme={"theme":"github-dark"} 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. | | 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 →](https://app.boxd.sh/integrations/detail/facebook)