Appearance
Messenger/IGv2 Page Moderate Conversations
Version
20.0.021.0.022.0.023.0.024.0.025.0.026.0.0
Copy for LLM
Moderate Messenger conversations by blocking, unblocking, banning, unbanning, or moving a user to spam.
Base URL
| | | | https://graph.facebook.com/v26.0 |
Endpoints
| | | | POST | /{page_id}/moderate_conversations |
POST /{page_id}/moderate_conversations
Request Syntax
POST /{page_id}/moderate_conversations
Try it
Select language
cURLJavaScriptPython
curl --request POST \
--url 'https://graph.facebook.com/v26.0/{page_id}/moderate_conversations' \
--header 'Authorization: Bearer <Token>' \
--header 'Content-Type: application/json' \
--data '{}'Path Parameters
page_idstring·required
The Facebook Page ID
Query Parameters
user_idsstring
JSON-encoded array of user objects with id field (e.g., [{"id":123}]). Alternative to request body — we recommend using the request body for POST requests.
actionsstring
JSON-encoded array of actions (e.g., ["block_user","unblock_user"]). Alternative to request body — we recommend using the request body for POST requests.
Request BodyRequired
Content Type: application/json
Schema: PageModerateConversationsRequest
Show child attributes
PageModerateConversationsRequest
user_idsarray of PageModerateConversationsUserId·required
List of Universal Scoped IDs to moderate (required, minimum 1, maximum 10). Supports both Messenger PSIDs and IG Scoped IDs. Each object contains an "id" field.
Show child attributes
user_ids[]PageModerateConversationsUserId
Show child attributes
idMust be one of: string, integer·required
The Universal Scoped ID (Messenger PSID or IG Scoped ID) of the user to moderate.
Show child attributes
string
User ID as a string.
integer
User ID as an integer.
actionsarray of One of "ban_user", "block_user", "move_to_spam", "unban_user", "unblock_user"·required
List of moderation actions to perform (required, minimum 1, maximum 2). Valid values: "ban_user", "block_user", "move_to_spam", "unban_user", "unblock_user".
Show child attributes
actions[]One of "ban_user", "block_user", "move_to_spam", "unban_user", "unblock_user"
Responses
200
Response indicating success or failure of the moderation action
Content Type: application/json
Schema: PageModerateConversationsResponse
Show child attributes
PageModerateConversationsResponse
successboolean·required
Indicates whether the moderation action was successful.
400
Bad request
Content Type: application/json
Schema: StandardError
Show child attributes
StandardError
messagestring·required
typestring
codeinteger·required
error_subcodeinteger
is_transientboolean
error_data{}
error_user_msgstring
error_user_titlestring
fbtrace_idstring
403
Forbidden
Content Type: application/json
Schema: StandardError
Show child attributes
StandardError
messagestring·required
typestring
codeinteger·required
error_subcodeinteger
is_transientboolean
error_data{}
error_user_msgstring
error_user_titlestring
fbtrace_idstring
Select language
cURLJavaScriptPython
curl --request POST \
--url 'https://graph.facebook.com/v26.0/{page_id}/moderate_conversations' \
--header 'Authorization: Bearer <Token>' \
--header 'Content-Type: application/json' \
--data '{}'Authentication
| | | | Scheme | Type | Location | | OAuthToken__access_token | API Key | Query: access_token | | OAuthToken__oauth_token | API Key | Query: oauth_token | | OAuthToken__Authorization | HTTP Bearer | Header: Authorization |
Usage Examples
OAuthToken__access_token:
Include access_token=your-api-key-here in query parameters
OAuthToken__oauth_token:
Include oauth_token=your-api-key-here in query parameters
OAuthToken__Authorization:
Include Authorization: Bearer your-token-here in request headers
Global Authentication Requirements
All endpoints require:
OAuthToken__access_token AND OAuthToken__oauth_token AND OAuthToken__Authorization