← All Skills
F

Social & video

Facebook

Read posts, pages, and audience data.

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.

Triggers0

Things that can wake up your Facebook coworker.

No triggers published for Facebook yet — but you can still run it on a schedule or from a chat.

Actions18

Things your coworker can do in Facebook.

  • Create Comment

    Creates a comment on a Facebook post or replies to an existing comment.

    FACEBOOK_CREATE_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 granted to your Facebook application. This action is publicly visible on the Page; confirm with the user before calling.

    FACEBOOK_CREATE_PHOTO_ALBUM
  • 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.

    FACEBOOK_CREATE_PHOTO_POST
  • 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.

    FACEBOOK_CREATE_POST
  • 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.

    FACEBOOK_CREATE_VIDEO_POST
  • 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.

    FACEBOOK_GET_COMMENTS
  • Get Conversation Messages

    Retrieves messages from a specific conversation.

    FACEBOOK_GET_CONVERSATION_MESSAGES
  • Get Page Conversations

    Retrieves a list of conversations between users and the Page.

    FACEBOOK_GET_PAGE_CONVERSATIONS
  • 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 comprehensive view of page activity. Pagination: follow paging.cursors.after or paging.next across multiple calls until no next cursor exists. Throttling: high-volume pagination can trigger Graph API errors 4 and 613; use backoff between requests. API Version: Uses v23.0 (released May 2025). v20.0 and earlier will be deprecated by Meta. See: https://developers.facebook.com/docs/graph-api/changelog

    FACEBOOK_GET_PAGE_POSTS
  • 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.

    FACEBOOK_GET_PAGE_TAGGED_POSTS
  • Get Post

    Retrieves details of a specific Facebook post.

    FACEBOOK_GET_POST
  • Search Pages

    Searches for Facebook Pages based on a query string. Returns pages matching the search criteria with requested fields. DEPRECATION WARNING: The /pages/search endpoint was deprecated by Facebook in 2019 and is now ONLY available to Workplace by Meta apps. Standard Facebook apps will receive Error #10 (permission error) regardless of which permissions or features have been granted. For Workplace apps only - requires one of: - 'pages_read_engagement' permission - 'Page Public Content Access' feature - 'Page Public Metadata Access' feature Standard Facebook apps should use alternative methods to discover pages, such as: - Direct page ID lookup via /{page-id} endpoint - User's managed pages via /me/accounts endpoint Reference: https://developers.facebook.com/docs/apps/review/feature#reference-PAGES_ACCESS. Results include only Facebook Pages; personal profiles, groups, and other entity types are excluded.

    FACEBOOK_SEARCH_PAGES
  • Send Media Message

    Sends a media message (image, video, audio, or file) from the Page to a user.

    FACEBOOK_SEND_MEDIA_MESSAGE
  • 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.

    FACEBOOK_SEND_MESSAGE
  • Unlike Post or Comment

    Removes a like from a Facebook post or comment.

    FACEBOOK_UNLIKE_POST_OR_COMMENT
  • 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.

    FACEBOOK_UPLOAD_PHOTO
  • Upload Photos Batch

    Uploads multiple photo files in batch to a Facebook Page or Album. Uses Facebook's batch API for efficient multi-photo upload. Maximum 50 photos per batch.

    FACEBOOK_UPLOAD_PHOTOS_BATCH
  • 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.

    FACEBOOK_UPLOAD_VIDEO