Connector Center

Meta / Instagram

Manual setup, diagnostics, assets, freshness, and governance restrictions. Browser authorization buttons are intentionally not exposed in this workflow.

Manage Export Diagnostics JSON

Overview

Meta / Instagram

Organic reach / Engagement / Comments needing review

Status

not configured

Connected Account

None

Auth Mode

oauth and manual

Manual Setup

Credentials and source notes

Meta/Instagram requires a configured Meta app, whitelisted redirect URI, Page, and linked Instagram Business/Creator account before authorization.

Provider docs

Account Label

Auth Mode

oauth and manual

Copy Redirect URI

https://os.luzione.com/api/integrations/meta/callback

Exact Scopes Requested

pages_show_list
pages_read_engagement
instagram_basic
instagram_manage_insights
instagram_manage_comments

Decode Last Setup State

Client ID is required before authorization.
Client secret is required before authorization.
Valid OAuth redirect URIs is required before authorization.
Client OAuth login enabled is required before authorization.
Web OAuth login enabled is required before authorization.
Permissions is required before authorization.
Facebook Page ID is required before authorization.
Instagram account ID is required before authorization.

Instagram accounts must be Business or Creator accounts linked to a Facebook Page.

Manual Token / API Key

Use this for personal access tokens, Admin API tokens, webhook secrets, and base IDs. Secret values are never shown again after save.

OAuth App Setup

Use this only for provider OAuth apps such as Google. If these values are in Vercel env vars, they are already durable.

Client IDClient secretRedirect URIValid OAuth redirect URIs

Additional Setup Notes

App domainsClient OAuth login enabledWeb OAuth login enabledPermissionsFacebook Page IDInstagram account IDBusiness portfolio verified

Operator Notes

Setup Checklist

Create or confirm the Meta app and Business assets.
Whitelist the exact redirect URI.
Record Page and Instagram Business Account IDs.
Confirm OAuth toggles and permissions.

Assets

Choose Assets is disabled until the provider is connected and asset listing is supported.

Required Environment

META_APP_IDMETA_APP_SECRET

Diagnostics

{
  "provider_key": "meta",
  "status": "not_configured",
  "required_env_present": false,
  "missing_env_vars": [
    "META_APP_ID",
    "META_APP_SECRET"
  ],
  "provider_setup_complete": false,
  "missing_setup_fields": [
    "clientId",
    "clientSecret",
    "validOAuthRedirectUris",
    "clientOAuthLogin",
    "webOAuthLogin",
    "permissions",
    "pageId",
    "instagramAccountId"
  ],
  "missing_setup_labels": [
    "Client ID",
    "Client secret",
    "Valid OAuth redirect URIs",
    "Client OAuth login enabled",
    "Web OAuth login enabled",
    "Permissions",
    "Facebook Page ID",
    "Instagram account ID"
  ],
  "setup_warnings": [
    "Instagram accounts must be Business or Creator accounts linked to a Facebook Page."
  ],
  "redirect_uri_expected": "https://os.luzione.com/api/integrations/meta/callback",
  "callback_route": "/api/integrations/meta/callback",
  "scopes": [
    "pages_show_list",
    "pages_read_engagement",
    "instagram_basic",
    "instagram_manage_insights",
    "instagram_manage_comments"
  ],
  "token_present": false,
  "token_expiry": null,
  "last_test_status": null,
  "last_test_error": null,
  "decoded_last_error": null,
  "app_review_required": true,
  "setup_steps": [
    "Create or confirm the Meta app and Business assets.",
    "Whitelist the exact redirect URI.",
    "Record Page and Instagram Business Account IDs.",
    "Confirm OAuth toggles and permissions."
  ],
  "assets_supported": true,
  "assets_selected": false,
  "governed_usage_allowed": true,
  "external_actions_enabled": false
}