Subscribing a Facebook Page to webhooks: the subscribed_apps edge
A Facebook Page is subscribed to an app's webhooks with POST /{page-id}/subscribed_apps, passing subscribed_fields such as feed,messages and a Page access token from someone with the CREATE_CONTENT, MANAGE or MODERATE task, with pages_manage_metadata and pages_show_list granted. Meta sends a field's events only when the app subscribes to it as well; GET lists the subscription and DELETE removes it.
easyCoexistence subscribes each Page you connect to feed, messages and mention through subscribed_apps, unsubscribes it when you remove it, and forwards the Page's events to your HTTPS endpoint signed with a secret for that Page, from one MCP connector or the Partner API.
Only fields subscribed at both the Page and the app level produce webhooks; a Page can list more than the app.
Page tasks, one of which the person behind the token needs to read or create a subscription.
Returned beside success when an app removes its webhook subscription from a Page with DELETE.
What /{app-id}/subscriptions requires to read, create or delete the app-level subscription.
Of failing Messenger deliveries before Meta unsubscribes the app from the Page until it subscribes again.
What does the subscribed_apps edge do?
It installs the app on the Page and sets which of the Page's webhook fields the app receives. Meta sends notifications only while the Page has the app installed and has not disabled the app platform in its settings, and only for fields subscribed at both levels: the Page's, through this edge, and the app's, set in the App Dashboard or through /{app-id}/subscriptions. A Page can be subscribed to more fields than the app.
How do you subscribe a Page?
With a POST to the edge, subscribed_fields listing the fields separated by commas, and the Page's access token. A successful call returns success true, and a call that lists messages needs pages_messaging on the token as well:
POST https://graph.facebook.com/{page-id}/subscribed_apps
?subscribed_fields=feed,messages,mention
&access_token=<PAGE_ACCESS_TOKEN>
{ "success": true }Which token, tasks and permissions does it need?
A Page access token, which ties the call to one Page, from someone who can act on that Page. Meta's references and guides set these requirements:
- Any field: a person with the
CREATE_CONTENT, MANAGE or MODERATE task, andpages_manage_metadatawithpages_show_list. - messages and the other Messenger fields:
pages_messagingas well, on a token from someone who can perform the MESSAGING task. - leadgen: the ADVERTISE task, with
leads_retrieval,pages_read_engagementandads_management. - Reading the subscription with GET takes the same tasks and permissions as creating it.
Which access level do the fields need?
Advanced Access, for Pages and people outside the app's own roles. With Standard Access, Messenger notifications come only from people with a role on the app, such as its admins, developers and testers; Advanced Access, granted per permission through App Review and requiring Business Verification, opens them to the app's customers. Meta's Messenger guide also lists publishing the app among the prerequisites.
What is the app-level subscription?
The other half: the fields the app itself listens to, with its callback URL. It is set in the App Dashboard or with POST /{app-id}/subscriptions and an app access token, passing object=page, callback_url, fields, include_values and verify_token, which sets off Meta's verification request. GET on the same edge shows each object's callback_url, fields and whether the subscription is active, a new POST amends the fields without overwriting the others, and DELETE removes them all or the fields named.
How do you check what a Page is subscribed to?
With a GET on the same edge and the Page's token. The data array lists each app the Page has installed, with its name, ID and subscribed_fields, and comes back empty when the Page has no apps installed:
GET https://graph.facebook.com/{page-id}/subscribed_apps
?access_token=<PAGE_ACCESS_TOKEN>
{
"data": [
{
"category": "Business",
"link": "https://example.com/app",
"name": "<APP_NAME>",
"id": "<APP_ID>",
"subscribed_fields": ["feed", "messages", "mention"]
}
]
}How do you remove a subscription?
With DELETE /{page-id}/subscribed_apps, which dissociates the app from the Page; an app can remove its own subscription with an app access token, and the response holds success and messaging_success. Meta also removes it on its own: after an hour of failing Messenger deliveries, the app is unsubscribed from the Page and has to subscribe again once its endpoint works.
What does easyCoexistence do at connect?
It subscribes each Page the person picks, right after saving that Page's token: POST /{page-id}/subscribed_apps with subscribed_fields set to feed,messages,mention. If Meta refuses, the Page stays connected and list_social_accounts shows the reason in last_error. Removing the Page sends DELETE /{page-id}/subscribed_apps before the token is discarded, and no tool reaches subscribed_apps or token paths, so the subscription is managed by easyCoexistence alone.
Common mistakes
- Calling the edge with a user access token. It takes the Page access token of the Page being subscribed.
- Subscribing the Page but not the app. A field reaches the callback only when the app's own subscription includes it too.
- Leaving pages_messaging out when subscribing to messages. Meta requires it, on a token from someone who can perform the MESSAGING task.
- Forgetting to subscribe again after an outage. An hour of failed Messenger deliveries unsubscribes the app, and events stop until the POST is sent again.
US$ 9 to US$ 0.75 per connection per month, falling as you add connections, with the first 3 days free.
easyCoexistence is a multichannel API and MCP server that connects AI agents such as Claude and ChatGPT to WhatsApp, Instagram, TikTok, Facebook and more. On WhatsApp it uses Coexistence: the business keeps using its number in the WhatsApp Business app while the AI works through Meta's official API.
Frequently asked questions
Do I need to subscribe each Page separately?
Yes. subscribed_apps works per Page, with that Page's own token, while the app-level subscription for the page object applies to the Pages that installed the app.
Why does subscribed_apps return error 200?
Meta lists 200 as a permissions error for this edge. Check that the token carries pages_manage_metadata and pages_show_list and comes from someone with CREATE_CONTENT, MANAGE or MODERATE.
Can a Page be subscribed from Graph API Explorer?
Yes. Meta's guide picks the app, gets a user token with pages_manage_metadata, exchanges it for the Page's token and sends the POST to {page-id}/subscribed_apps.
Can I add webhook fields to a Page connected to easyCoexistence?
Not through its tools: none reaches subscribed_apps paths, and the Page stays subscribed to feed, messages and mention, the fields easyCoexistence forwards.
Keep reading
Connect your first channel in two minutes.
No platform reviews to wait for. Connect WhatsApp, Instagram, TikTok or another channel, then ask your AI to post, reply or report, and watch it work.
- 3 days free
- Cancel any time
- Official APIs only
- Monitored 24/7
Verified on