GitDocs
OAuth scope contract drift

Meta WhatsApp Embedded Signup OAuth scopes whatsapp_business_messaging whatsapp_business_management business_management v23.0

WhatsApp Embedded Signup creates an inbox or token but webhook registration or WABA access fails because current OAuth scopes do not match the integration.

search-observedMeta WhatsApp Cloud APIExternal SaaS APIOAuth scope contract driftlegacy

Agent Quick Fix

The local repository can expose the failure, but the decisive repair depends on the current host, package, runtime, or API contract.

Product: Meta WhatsApp Cloud API
Current-contract area: Meta WhatsApp Embedded Signup OAuth scopes whatsapp_business_messaging whatsapp_business_management business_management v23.0
Likely root cause: WhatsApp Embedded Signup creates an inbox or token but webhook registration or WABA access fails because current OAuth scopes do not match the integration.
Repair direction: Use the source trail below to align the local install, host, API, or runtime configuration with the current external contract.

Validation Status

Codex searched organically in the validation run. No no-web counterfactual is attached to this page yet.

Symptom

WhatsApp Embedded Signup creates an inbox or token but webhook registration or WABA access fails because current OAuth scopes do not match the integration.

Why This Happens

The local repository can expose the failure, but the decisive repair depends on the current host, package, runtime, or API contract.

Verification

Use the source trail below to align the local install, host, API, or runtime configuration with the current external contract.

Common Wrong Fixes

  • Changing local code without checking the current external contract.
  • Retrying the same install, build, or API call with no version/source change.
  • Applying a broad unsafe bypass when a narrow compatibility fix is available.

Codex Search Keywords

These are the search terms observed in a neutral Codex validation run for this failure shape.

Meta WhatsApp Embedded Signup OAuth scopes whatsapp_business_messaging whatsapp_business_management business_management v23.0
Chatwoot Meta OAuthException #100 webhook registration WhatsApp Embedded Signup
Chatwoot No WABA scope found in token apps v23.0

Source Trail