Connector Center

Meta Ads

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

Manage Export Diagnostics JSON

Overview

Meta Ads

Spend / CTR / CPC / Conversions

Status

not configured

Connected Account

None

Auth Mode

oauth and manual

Manual Setup

Credentials and source notes

Meta Ads reporting starts with ads_read. Advanced Access and Business Verification may be required before production reporting works.

Provider docs

Account Label

Auth Mode

oauth and manual

Copy Redirect URI

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

Exact Scopes Requested

ads_read

Decode Last Setup State

Client ID is required before authorization.
Client secret is required before authorization.
Valid OAuth redirect URIs is required before authorization.
Permissions is required before authorization.
Ad account ID is required before authorization.
Business Manager ID is required before authorization.
Advanced access approved is required before authorization.

Default to ads_read; ads_management should stay optional until campaign edits are intentionally enabled.

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

PermissionsAd account IDBusiness Manager IDAdvanced access approved

Operator Notes

Setup Checklist

Confirm Business Manager and ad account access.
Whitelist the exact redirect URI.
Save ad account and Business Manager IDs.
Keep ads_management disabled unless campaign edits are intentionally enabled.

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-ads",
  "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",
    "permissions",
    "adAccountId",
    "businessManagerId",
    "advancedAccessApproved"
  ],
  "missing_setup_labels": [
    "Client ID",
    "Client secret",
    "Valid OAuth redirect URIs",
    "Permissions",
    "Ad account ID",
    "Business Manager ID",
    "Advanced access approved"
  ],
  "setup_warnings": [
    "Default to ads_read; ads_management should stay optional until campaign edits are intentionally enabled."
  ],
  "redirect_uri_expected": "https://os.luzione.com/api/integrations/meta/callback",
  "callback_route": "/api/integrations/meta-ads/callback",
  "scopes": [
    "ads_read"
  ],
  "token_present": false,
  "token_expiry": null,
  "last_test_status": null,
  "last_test_error": null,
  "decoded_last_error": null,
  "app_review_required": true,
  "setup_steps": [
    "Confirm Business Manager and ad account access.",
    "Whitelist the exact redirect URI.",
    "Save ad account and Business Manager IDs.",
    "Keep ads_management disabled unless campaign edits are intentionally enabled."
  ],
  "assets_supported": true,
  "assets_selected": false,
  "governed_usage_allowed": true,
  "external_actions_enabled": false
}