A connection lacks a permission for a new use

Area: Account and access · Updated: 1 Nov 2026 · Auf Deutsch · All articles

Symptoms

  • „Bestehende Verbindung verwenden“ or connection_uses_create answers connection_scopes_missing with a list such as leads_retrieval.
  • X3 Konto › Verbindungen shows „Berechtigung fehlt“ at the status and „es fehlt: …“ at a use.
  • Sales › Einstellungen › Verbindungen reads „Facebook hat nicht alle Berechtigungen erteilt (…)“.

Cause

  • When the page was connected, a box in the Facebook dialog was unticked, so Facebook never granted that permission.
  • The new purpose needs a permission the old one did not (Instant Form leads need leads_retrieval, pages_show_list and pages_manage_metadata).

How to fix it

1. See what is missing

  • In the dashboard: X3 Konto › Verbindungen › the connection › Genutzt in
  • With Claude (MCP): connection_status {"org":"my-company","connection_id":"… id from connections_list"}

reauthorize.missingScopes lists the missing permissions, reauthorize.possible whether you may ask for them (project:admin of the project where the page was connected).

2. Ask for the permissions again

  • In the dashboard: X3 Konto › Verbindungen › the connection › Berechtigungen erneut anfragen
  • With Claude (MCP): No MCP tool (The consent happens in the browser at Facebook with your own sign-in; X3 never takes tokens through Claude)

Facebook shows the boxes again; tick every one, then pick the same page. The connection keeps its place, its uses and their settings. With MCP, open accountUrl from connection_status.

3. Add the use

  • In the dashboard: Sales › Einstellungen › Verbindungen › Facebook-Lead-Formulare › Bestehende Verbindung verwenden
  • With Claude (MCP): connection_uses_create {"org":"my-company","connection_id":"… id from connections_list","product":"sales","purpose":"instant_forms"}

How to tell it worked

  • X3 Konto › Verbindungen lists the permissions under „Erteilte Berechtigungen“ and no use shows „es fehlt“.
  • connection_status answers reauthorize.missingScopes empty.