capabilities flag is true on a Facebook comment. A public reply costs 1 interaction credit, and every other comment call costs none. For the rules shared by every platform, see Comments.
Endpoints
{post_id} is Facebook’s post ID: digits only, or {page_id}_{post_id}. GET /v1/inbox/comments/{post_id} returns 400 validation.field_invalid for a post_id that cannot be a post ID, such as posts or a sapi_cmt_ ID. {comment_id} accepts the comment’s sapi_cmt_ ID or Facebook’s comment ID: see IDs. SocialAPI has no endpoint to edit a comment.
List the comments on a Page post
List the Facebook posts of one account that have comments:page_id is the SocialAPI ID of the Facebook Page that published the post. Read the comments on that post. account_id is required:
comment_id in the response is the new reply’s sapi_cmt_ ID. Omit comment_id in the request to comment on the post itself.
How Facebook fills a comment
GET /v1/inbox/comments/{post_id} returns the top-level comments of the post. Replies are not in that list: read them with GET /v1/inbox/comments/{post_id}/{comment_id}/replies, which returns them in the same shape, each with parent_id set to the platform_id of the comment they answer. The full field list is in List comments and replies.
limit is 25 comments or 10 replies by default, up to 100. A page can hold fewer items than limit, because Facebook sets its own page size. Follow next_cursor until has_more is false: see Pagination. Facebook ignores the moderation_status, order, and q parameters, which filter YouTube comments only. A value outside their allowed lists still returns 400 validation.field_invalid.
Accounts with more than one Page
A connected Facebook account can hold more than 1 Page. Comment calls take no Page parameter: SocialAPI acts as the Page that published the post. On an account with more than 1 Page, list the post withGET /v1/inbox/comments before acting on its comments. Until that list returns the post, SocialAPI acts as the account’s default Page (is_default: true in GET /v1/accounts/{account_id}/pages), and a call on another Page’s post fails. To list the posts of one Page, pass page_id, the Page’s SocialAPI ID, to GET /v1/inbox/comments. See Pages of an account.
Reply to a comment
POST /v1/inbox/comments/{post_id} posts a public reply as the Page. account_id and text are required: a missing one returns 400 validation.field_required. With comment_id, the reply answers that comment. Without it, the Page comments on the post.
A reply costs 1 interaction credit. When the plan’s interaction allowance is used up, the call returns 429 validation.interaction_limit_exhausted. A reply that fails with a validation.* error returns its credit: see When a credit comes back.
Private replies
A private reply is a one-time Messenger DM from the Page to the person who wrote a comment. Send it withPOST /v1/inbox/comments/{post_id}/{comment_id}/private-reply. The public reply endpoint never sends one.
Facebook allows 1 private reply per comment, within 7 days of the comment.
- A second private reply, or a comment older than 7 days, returns
400 platform.facebook.private_reply_ineligible. When Facebook refuses the reply,error.meta.fbtrace_idholds Facebook’s trace ID for Meta support when Facebook sends one. When the comment is already known to be ineligible, the error instead carrieserror.meta.blocked_locally: trueanderror.meta.reason:already_replied,platform_refused, orwindow_expired. Whenerror.meta.blocked_locallyistrue, or the reply was text only, this 400 is final. When Facebook refuses a reply that carriedbuttonsor an attachment, the refusal can come from that content: send it once more as text only. - An attachment Facebook cannot fetch or accept returns
422 platform.facebook.attachment_failed, and the comment can still receive its private reply. Check that the URL is public and the file is supported, then send again. - An attachment with
textorbuttonsreturns400 validation.attachment_conflict. A private reply is one message.
messages.write permission, not comments.write. A private reply does not open the messaging window: the Page can message the person again only after the person answers.
Hide and unhide a comment
POST /v1/inbox/comments/{post_id}/{comment_id}/hide, with account_id in the body, hides a comment from the public, and DELETE on the same path, with account_id as a query parameter, shows it again. Both return { "success": true }. A hidden comment stays visible to the person who wrote it.
Facebook refuses to hide or unhide some comments, for example a comment the Page’s moderation filters already hid. That refusal returns 422 platform.facebook.comment_not_hideable, and retrying does not help. Examples of both calls are in Hide and unhide a comment.
Delete a comment
DELETE /v1/inbox/comments/{post_id}/{comment_id}?account_id={account_id} deletes the comment on Facebook and returns { "success": true }. The Page can delete any comment on its own posts, including comments other people wrote. Deleting cannot be undone. To remove a comment from public view and keep the option to restore it, hide it instead.
Like and unlike a comment
POST /v1/inbox/comments/{post_id}/{comment_id}/like likes a comment as the Page, and DELETE on the same path removes the Page’s like. Both take account_id: in the body for POST, as a query parameter for DELETE. Both return { "success": true }. SocialAPI has no endpoint for other reactions on a comment.
Edited comments and Automations
- Edits. Facebook sends an edited comment again as a
comment.receivedevent, with the same commentidand the new text. - Automations answer new comments only. An Automation ignores an edit, and skips comments the Page wrote. A Page admin who comments from a personal profile is a commenter like any other, so the comment triggers the Automation.
Limits
Facebook’s own rate limit returns
429 platform.facebook.rate_limit. See Rate limits.
Errors and debugging
Check these in order when a Facebook comment call fails or returns nothing:401,403 auth.insufficient_scope. The API key is invalid, or a scoped key lacks the scope in Scopes.404 account.not_found,403 account.reconnection_required,401 platform.facebook.auth. Theacc_ID is not yours, or the account needs reconnecting.403 account.permission_missing. The account lacks the permission the call needs:comments.readto list comments and replies,comments.writeto reply, hide, unhide, delete, like, or unlike, andmessages.writefor a private reply.error.meta.permissionnames it.400 validation.*. The request is wrong: a required field is missing, an attachment comes withtextorbuttons, a button breaks its limits, or, onGET /v1/inbox/comments/{post_id},post_idcannot be a post ID, such aspostsor asapi_cmt_ID. For avalidation.*error,error.meta.fieldnames the field.400 validation.id_invalid,400 validation.id_platform_mismatch. The comment ID is the wrong type, or belongs to another platform.404 resource.not_found. The post or comment was deleted on Facebook.400 platform.facebook.private_reply_ineligible. The comment already received its private reply, or is older than 7 days. Whenerror.meta.blocked_locallyistrue, or the reply was text only, this 400 is final. When Facebook refuses a reply that carriedbuttonsor an attachment, the refusal can come from that content: send it once more as text only.422 platform.facebook.attachment_failed. Facebook could not fetch or accept the file of a private reply. Fix the URL or the file and send again.422 platform.facebook.comment_not_hideable. Facebook refused to hide or unhide the comment.403 platform.facebook.permission_denied,404 platform.facebook.100.403 platform.facebook.permission_deniedmeans the Facebook scopes granted at connect do not cover the call: reconnect the account and approve every scope.404 platform.facebook.100means Facebook says the object does not exist, or the Page lacks a scope the call needs: check the ID, then reconnect and approve every scope.429 validation.interaction_limit_exhausted. The plan allowance is used up until the next billing period: see Plans.429 platform.facebook.rate_limit. Wait for theRetry-Afterheader when present.429 platform.facebook.throttled. Facebook refused the connected account, or one of its Pages, with its own rate limit, and SocialAPI refuses calls for that account or Page until the wait ends.error.meta.scopeisaccountorpage. Nothing was sent. Wait for theRetry-Afterheader, then retry.429 messaging.velocity_limit. The Page is sending messages or replies faster than SocialAPI allows. Wait for theRetry-Afterheader. Nothing was sent and no credit was used.403,404, or503 platform.facebook.<code>,503 platform.facebook.api_error, or501 resource.not_supported. Facebook returned an error that has no row above, where<code>is Meta’s error code: see Platform errors.
account_id owns the post. The full catalog is in Errors.
Scopes
The Facebook scopes the person grants at connect, and the account permissions each one belongs to, are in Facebook scopes.
Events
Facebook sendscomment.received when a person comments on a Page post or edits a comment. The event carries page_id, the SocialAPI ID of the Page that received the comment. A tap on a postback button of a private reply arrives as dm.postback. An account without the comments.read permission receives no comment.received events. The Facebook event list is in Facebook webhook events, and the payloads are in Webhook events.
Use from an AI agent
See MCP tools.
Related
- Facebook API: capabilities, Pages, scopes, and webhook events for Facebook
- Facebook direct messages: the Messenger conversation a private reply starts
- Comments: the comment endpoints and fields shared by every platform
- Automations: answer Facebook comments by keyword with no handler of your own
- Errors: every comment error code