Marketing & Social
📘 Facebook integration
Access levels: Read-only · Manage pages · Full access · Verified
Marketing & Social
Access levels: Read-only · Manage pages · Full access · Verified
Connect Facebook once and every agent in your squad can work in it for you, with exactly as much access as you decide to give, and a receipt for every call it makes.
You can change an account's access level any time under Manage. It applies instantly, no re-authorization. If the connection ever expires, the card shows Reconnect; one click re-authorizes the same account with the same settings.
Multiple accounts: connect as many as you need (say, yours and a client's). One is primary. Agents use it unless a mission says otherwise.
The level you pick at connect time is enforced on our side for every agent call: an agent can never do more than the level allows, no matter what it's asked.
| Level | What it allows | |
|---|---|---|
| Read-only | See your profile, pages, and engagement metrics. | |
| Manage pages | Post on pages, reply to comments, message users. | Recommended |
| Full access | Full access including ads. |
On top of the connection's level, every agent can be individually allowed, scoped down, or denied for this app from the Integrations page. Deny an agent and it doesn't even see the connection.
The 43 tools agents use in Facebook through Mission Control, and the lowest access level that includes each. Agents discover these themselves. You never have to name a tool; asking in plain language is enough.
| Tool | What it does | Access level |
|---|---|---|
Assign page taskFACEBOOK_ASSIGN_PAGE_TASK | Assigns tasks/roles to a business-scoped user or system user for a specific Facebook Page. | Manage pages, Full access |
Create commentFACEBOOK_CREATE_COMMENT | Creates a comment on a Facebook post or replies to an existing comment. | Manage pages, Full access |
Create photo albumFACEBOOK_CREATE_PHOTO_ALBUM | Creates a new photo album on a Facebook Page. | Manage pages, Full access |
Create photo postFACEBOOK_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 option… | Manage pages, Full access |
Create postFACEBOOK_CREATE_POST | Creates a new text or link post on a Facebook Page. | Manage pages, Full access |
Create video postFACEBOOK_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. | Manage pages, Full access |
Delete commentFACEBOOK_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. | Full access |
Delete postFACEBOOK_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. | Full access |
Get commentFACEBOOK_GET_COMMENT | Retrieves details of a specific Facebook comment. | All levels |
Get commentsFACEBOOK_GET_COMMENTS | Retrieves comments from a Facebook post or comment (for replies). | All levels |
Get conversation messagesFACEBOOK_GET_CONVERSATION_MESSAGES | Retrieves messages from a specific conversation. | All levels |
Get current userFACEBOOK_GET_CURRENT_USER | Validates the access token and retrieves the authenticated user's own profile via /me. | All levels |
Get message detailsFACEBOOK_GET_MESSAGE_DETAILS | Retrieves details of a specific message sent or received by the Page. | All levels |
Get page conversationsFACEBOOK_GET_PAGE_CONVERSATIONS | Retrieves a list of conversations between users and the Page. | All levels |
Get page detailsFACEBOOK_GET_PAGE_DETAILS | Fetches details about a specific Facebook Page. | All levels |
Get page insightsFACEBOOK_GET_PAGE_INSIGHTS | Retrieves analytics and insights for a Facebook Page. | All levels |
Get page photosFACEBOOK_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. | All levels |
Get page postsFACEBOOK_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) - /po… | All levels |
Get page rolesFACEBOOK_GET_PAGE_ROLES | Retrieves a list of people and their tasks/roles on a Facebook Page. | All levels |
Get page tagged postsFACEBOOK_GET_PAGE_TAGGED_POSTS | Retrieves posts where a Facebook Page is tagged or mentioned. | All levels |
Get page videosFACEBOOK_GET_PAGE_VIDEOS | Retrieves videos from a Facebook Page. | All levels |
Get postFACEBOOK_GET_POST | Retrieves details of a specific Facebook post. | All levels |
Get post insightsFACEBOOK_GET_POST_INSIGHTS | Retrieves analytics and insights for a specific Facebook post. | All levels |
Get post reactionsFACEBOOK_GET_POST_REACTIONS | Retrieves reactions (like, love, wow, etc.) for a Facebook post. | All levels |
Get scheduled postsFACEBOOK_GET_SCHEDULED_POSTS | Retrieves scheduled and unpublished posts for a Facebook Page. | All levels |
Get user pagesFACEBOOK_GET_USER_PAGES | DEPRECATED: Use FACEBOOK_LIST_MANAGED_PAGES instead. | All levels |
Like post or commentFACEBOOK_LIKE_POST_OR_COMMENT | Adds a LIKE reaction to a Facebook post or comment. | Manage pages, Full access |
List managed pagesFACEBOOK_LIST_MANAGED_PAGES | Retrieves a list of Facebook Pages that the user manages (not personal profiles), including page details, access tokens, and tasks. | All levels |
Mark message seenFACEBOOK_MARK_MESSAGE_SEEN | Marks a user's message as seen by the Page, visibly updating the read status in the user's conversation. | Manage pages, Full access |
Publish scheduled postFACEBOOK_PUBLISH_SCHEDULED_POST | Publishes a previously scheduled or unpublished Facebook post immediately. | Manage pages, Full access |
Remove page taskFACEBOOK_REMOVE_PAGE_TASK | Removes a user's tasks/access from a specific Facebook Page. | Full access |
Reschedule postFACEBOOK_RESCHEDULE_POST | Changes the scheduled publish time of an unpublished Facebook post. | Manage pages, Full access |
Search pagesFACEBOOK_SEARCH_PAGES | Searches for Facebook Pages based on a query string. | All levels |
Send media messageFACEBOOK_SEND_MEDIA_MESSAGE | Sends a media message (image, video, audio, or file) from the Page to a user. | Manage pages, Full access |
Send messageFACEBOOK_SEND_MESSAGE | Sends a text message from a Facebook Page (not personal profiles) to a user via Messenger. | Manage pages, Full access |
Toggle typing indicatorFACEBOOK_TOGGLE_TYPING_INDICATOR | Shows or hides the typing indicator for a user in Messenger. | Manage pages, Full access |
Unlike post or commentFACEBOOK_UNLIKE_POST_OR_COMMENT | Removes a like from a Facebook post or comment. | Full access |
Update commentFACEBOOK_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,… | Manage pages, Full access |
Update page settingsFACEBOOK_UPDATE_PAGE_SETTINGS | Updates settings for a specific Facebook Page. | Manage pages, Full access |
Update postFACEBOOK_UPDATE_POST | Updates an existing Facebook Page post. | Manage pages, Full access |
Upload photoFACEBOOK_UPLOAD_PHOTO | DEPRECATED: Use FACEBOOK_CREATE_PHOTO_POST instead. | Manage pages, Full access |
Upload photos batchFACEBOOK_UPLOAD_PHOTOS_BATCH | Uploads multiple photo files in batch to a Facebook Page or Album. | Manage pages, Full access |
Upload videoFACEBOOK_UPLOAD_VIDEO | 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 process… | Manage pages, Full access |
Just ask in plain language: “check Facebook for …”, “create … in Facebook”, “every Monday, … ”, and the agent finds the right tool, runs it, and reports back with a receipt in your Runs ledger. Anything outward-facing (sending, posting, publishing) that a mission didn't clearly authorize comes back to you as a ticket first.
| Agent says | What's happening | Fix |
|---|---|---|
| "Facebook isn't connected" | No active connection (or this agent is denied) | Connect on the Integrations page; check the agent's per-app policy |
| "The connection has expired" | Facebook ended the authorization (they all do periodically) | Click Reconnect on the account, same settings, one click |
| "I'm not allowed to do that" | The action is above the account's access level, or the agent is scoped down | Raise the level under Manage, or adjust that agent's policy |
| It did something unexpected | The ask was ambiguous (e.g. matched an existing item) | Be explicit, "create a NEW …", and give agents a working folder where relevant |