Get page (yekar.facebook-pages.get-page) | Read | The Page this connection is configured for: name, category, public URL, follower and like counts as Facebook counts them, verification status, and whether the Page is published at all. Call it first when something is not working - a token for the wrong Page fails every other tool with an unhelpful 'no such id'. |
List posts (yekar.facebook-pages.list-posts) | Read | A page of the Page's published posts, newest first - id, text, permalink, and when it went out. SCHEDULED posts are NOT here: Facebook keeps them on a separate edge until they publish, so use List scheduled posts to see those. Graph returns no total for a page, so this reports whether more pages remain rather than a count. |
List scheduled posts (yekar.facebook-pages.list-scheduled-posts) | Read | The Page's posts that are scheduled but not yet published, with the time each will go live. This tool exists because a scheduled post is INVISIBLE to List posts - Facebook keeps the two on separate edges - so without it a scheduled post appears to have vanished. Each item's published flag is false and scheduledFor holds the publish time. |
Get post (yekar.facebook-pages.get-post) | Read | Read one post: its text, permalink, creation and update times, and - importantly - whether it is actually published or still scheduled. A post id that this Page's token cannot see returns 'no such id', which Facebook also uses for deleted posts; the two are indistinguishable from here. |
Create post (yekar.facebook-pages.create-post) | Write | Publish a text post to the Page, optionally sharing a link, and optionally scheduling it instead of publishing now. Facebook refuses a post whose message is identical to the previous one, so a retry with unchanged text will fail as a duplicate rather than post twice. A scheduled post is invisible to List posts until it goes live - find it with List scheduled posts. |
Create photo post (yekar.facebook-pages.create-photo-post) | Write | Post a photo to the Page from a public image URL, with an optional caption, optionally scheduled. Facebook downloads the image itself, so the URL must be reachable without authentication - a signed or expiring link usually fails. The result carries two ids: the photo and the feed post it created; comments and insights belong to the POST id. |
Update post (yekar.facebook-pages.update-post) | Write | Replace the text of a post the Page published. Only the message can be changed: a shared link, an attached photo and the audience are fixed once posted, and Facebook shows an edit history to anyone who looks. Editing does not re-notify followers, so an edit is not a way to resurface a post. |
Delete post (yekar.facebook-pages.delete-post) | Write | Permanently delete a post from the Page, along with its comments, reactions and insights. There is no trash and no undo. A scheduled post that has not published yet is deleted the same way, and that is the only way to cancel one - Facebook's API cannot move a scheduled post's time. |
List comments (yekar.facebook-pages.list-comments) | Read | A page of comments on a post - or, passing a comment id, that comment's replies. Each item carries the comment id needed to reply, hide or delete it, and whether it is currently hidden. The total comes from Facebook's own summary count for the whole object, so it is the real number rather than the size of this page. |
Create comment (yekar.facebook-pages.create-comment) | Write | Comment on a post as the PAGE (not as a person), or reply to an existing comment by passing its id. The comment is public immediately and appears under the Page's name and picture. Facebook allows only one level of replies - replying to a reply attaches to the same top-level thread. |
Hide comment (yekar.facebook-pages.hide-comment) | Write | Hide a comment from the public, or unhide one. A hidden comment stays visible to its author and their friends - Facebook deliberately does not tell them it was hidden - and remains readable by the Page, so hiding is the reversible moderation action and deleting is the permanent one. Prefer this over Delete comment for anything that might have been a misjudgement. |
Delete comment (yekar.facebook-pages.delete-comment) | Write | Permanently delete a comment and every reply under it. There is no undo, and unlike hiding, the author can tell - their comment is gone. Use Hide comment when the judgement might be wrong; use this for spam and abuse. |
Get post insights (yekar.facebook-pages.get-post-insights) | Read | Reach and engagement for one post - impressions, unique impressions, clicks and reactions by type by default. Needs the read_insights permission. A metric Facebook has retired in the current Graph version is not an error: it comes back MISSING, so this reports those separately as unavailable rather than letting them look like zeros. |
Get page insights (yekar.facebook-pages.get-page-insights) | Read | Page-level reach and engagement over a window - impressions, unique impressions, post engagements and follower count by default. Needs the read_insights permission. Facebook backfills insights with a delay of up to a day, so the most recent window is routinely incomplete rather than low; metrics retired in the current Graph version are reported as unavailable, not as zeros. |