Facebook Messenger Platform

graph.facebook.com_messenger

Community

Send and manage messages on Facebook Messenger at scale. Create automated conversations, send rich media attachments, configure bot settings, and handle bot-to-human handoffs via the Handover Protocol.

[catalog]Catalog only — enable via gateway with your own API key

Enable this service

This service is in the catalog but not part of v1 launch billing. To use it, run the command below and provide your own API key in the local config page — the gateway will call it under your account.

Auth

api_key

Pricing

free

Spec version

1.0

Base URL

https://graph.facebook.com/v18.0

Last crawled

Aug 7, 2026

Health

This is a community-maintained manifest. Health monitoring is not available because this service doesn't host its own /.well-known/agent endpoint yet. Learn more about trust levels →

Top Capabilities

Most commonly used operations — ready to call without drill-down.

messenger_profile_get

GET

Retrieve current Messenger Profile settings.

GET https://graph.facebook.com/v18.0/me/messenger_profile

fields (string, required) — Comma-separated list of profile fields: greeting, get_started, persistent_menu, whitelisted_domains, ice_breakers.

user_profile_get

GET

Retrieve a Messenger user's profile information.

GET https://graph.facebook.com/v18.0/{user_id}

user_id (string, required) — The PSID of the Messenger user.

fields (string) — Comma-separated profile fields: first_name, last_name, profile_pic, locale, timezone, gender.

messages_send

POST

Send a text message to a user on Messenger.

POST https://graph.facebook.com/v18.0/me/messages

recipient_id (string, required) — The PSID (Page-Scoped ID) of the Messenger recipient.

message_text (string, required) — The text content of the message to send (max 2000 characters).

messaging_type (string, required) — The messaging type: RESPONSE, UPDATE, or MESSAGE_TAG.

tag (string) — Message tag for sending outside the 24-hour window. Required when messaging_type is MESSAGE_TAG.

All Capabilities (17)

attachments (1)

POSTattachment_upload

Upload a reusable attachment for later use in messages.

handover (3)

POSThandover_pass_thread_control

Pass conversation control to another app for bot-to-human handoff.

POSThandover_request_thread_control

Request thread control from the primary receiver app.

POSThandover_take_thread_control

Take thread control from another app as the primary receiver.

messages (4)

POSTmessages_send

Send a text message to a user on Messenger.

POSTmessages_send_attachment

Send an image, video, audio, or file attachment to a Messenger user.

POSTmessages_send_quick_replies

Send a message with quick reply buttons for predefined responses.

POSTmessages_send_template

Send structured message templates for rich interactive experiences.

messenger_profile (7)

DELETEmessenger_profile_delete

Delete specific Messenger Profile properties.

GETmessenger_profile_get

Retrieve current Messenger Profile settings.

POSTmessenger_profile_set_get_started

Configure the Get Started button for new users.

POSTmessenger_profile_set_greeting

Set a greeting text on the welcome screen.

POSTmessenger_profile_set_ice_breakers

Configure suggested conversation starter questions.

POSTmessenger_profile_set_persistent_menu

Configure a persistent navigation menu at the bottom of conversations.

POSTmessenger_profile_set_whitelisted_domains

Set whitelisted domains for Messenger Extensions and webviews.

sender_actions (1)

POSTsender_actions_set

Send typing indicators or mark messages as read.

users (1)

GETuser_profile_get

Retrieve a Messenger user's profile information.

Agent Preview

This is what an AI agent sees when it discovers this service via the Gateway:

Service: Facebook Messenger Platform
Description: Send and manage messages on Facebook Messenger at scale. Create automated conversations, send rich media attachments, configure bot settings, and handle bot-to-human handoffs via the Handover Protocol.
Auth: api_key
Capabilities (17 total):
  attachments (1):
    - attachment_upload: Upload a reusable attachment for later use in messages.
  handover (3):
    - handover_pass_thread_control: Pass conversation control to another app for bot-to-human handoff.
    - handover_request_thread_control: Request thread control from the primary receiver app.
    - handover_take_thread_control: Take thread control from another app as the primary receiver.
  messages (4):
    - messages_send: Send a text message to a user on Messenger.
    - messages_send_attachment: Send an image, video, audio, or file attachment to a Messenger user.
    - messages_send_quick_replies: Send a message with quick reply buttons for predefined responses.
    - messages_send_template: Send structured message templates for rich interactive experiences.
  messenger_profile (7):
    - messenger_profile_delete: Delete specific Messenger Profile properties.
    - messenger_profile_get: Retrieve current Messenger Profile settings.
    - messenger_profile_set_get_started: Configure the Get Started button for new users.
    - messenger_profile_set_greeting: Set a greeting text on the welcome screen.
    - messenger_profile_set_ice_breakers: Configure suggested conversation starter questions.
    - messenger_profile_set_persistent_menu: Configure a persistent navigation menu at the bottom of conversations.
    - messenger_profile_set_whitelisted_domains: Set whitelisted domains for Messenger Extensions and webviews.
  sender_actions (1):
    - sender_actions_set: Send typing indicators or mark messages as read.
  users (1):
    - user_profile_get: Retrieve a Messenger user's profile information.

Top capabilities (ready to call):
  - messenger_profile_get: GET /me/messenger_profile
  - user_profile_get: GET /{user_id}
  - messages_send: POST /me/messages