Errors — Meta
Numeric codes follow domain × 10,000 + category × 100 + ordinal ( see defineErrors in the Cognis domain package). The Message key column is the stable key returned in API payloads; the Message column shows the copy for your current locale (same resolution as the product UI).
| Code | Key | HTTP | Category | Message key | Message |
|---|---|---|---|---|---|
| 150104 | META_VALIDATION_ERROR | 422 | Validation | meta.errors.validationError | Ad account timezone is required for Meta launches. |
| 150106 | META_BACKFILL_ATTRIBUTION_REQUIRED | 400 | Validation | org.errors.integrations.meta.backfill.attributionRequired | org.errors.integrations.meta.backfill.attributionRequired |
| 150107 | META_BACKFILL_TIMEZONE_REQUIRED | 400 | Validation | org.errors.integrations.meta.backfill.timezoneRequired | Set a timezone for this ad account before starting the lifetime backfill. |
| 150110 | META_SYSTEM_USER_TOKEN_LIFETIME_REQUIRED | 400 | Validation | org.errors.integrations.meta.systemUserToken.lifetimeRequired | This token expires on {{expiresDate}}. System user tokens must use 'Never' expiry (lifetime). In Business Settings → System Users, click 'Generate New Token', select the Cognis app, and set Token Expiration to 'Never'. |
| 150111 | META_SYSTEM_USER_TOKEN_REQUIRED | 400 | Validation | org.errors.integrations.meta.systemUserToken.required | A verified system user token is required to launch campaigns. Go to Meta Integration → System User and submit a lifetime token for the business that owns this ad account. |
| 150112 | META_OAUTH_STATE_INVALID | 400 | Validation | org.errors.integrations.meta.oauth.stateInvalid | Invalid OAuth state. Return to the integration page and start the Meta connection again. |
| 150113 | META_OAUTH_TOKEN_EXCHANGE_FAILED | 400 | Validation | org.errors.integrations.meta.oauth.tokenExchangeFailed | Meta could not exchange the authorization code for an access token. Try connecting again. |
| 150114 | META_OAUTH_BUSINESS_NOT_DISCOVERED | 400 | Validation | org.errors.integrations.meta.oauth.businessNotDiscovered | The specified business was not discovered during the Meta OAuth flow. Reconnect the integration and ensure this Business Manager is available to your Meta user. |
| 150115 | META_SYSTEM_USER_TOKEN_VERIFY_FAILED | 400 | Validation | org.errors.integrations.meta.systemUserToken.verifyFailed | The provided token could not be verified. Check that it is correct and try again. |
| 150116 | META_SYSTEM_USER_TOKEN_INVALID_OR_EXPIRED | 400 | Validation | org.errors.integrations.meta.systemUserToken.invalidOrExpired | The token is invalid or has expired. |
| 150117 | META_SYSTEM_USER_TOKEN_WRONG_APP | 400 | Validation | org.errors.integrations.meta.systemUserToken.wrongApp | This token is for Meta app {{tokenAppId}}, but this Cognis environment expects app {{expectedAppId}}. Generate the system user token for the Cognis Meta app, not another app. |
| 150118 | META_SYSTEM_USER_TOKEN_WRONG_TYPE | 400 | Validation | org.errors.integrations.meta.systemUserToken.wrongType | Expected a System User token but received type '{{tokenType}}'. Generate the token from Business Settings → System Users, not from a personal account. |
| 150119 | META_SYSTEM_USER_TOKEN_BUSINESS_ACCESS_DENIED | 400 | Validation | org.errors.integrations.meta.systemUserToken.businessAccessDenied | The system user token does not have access to business '{{businessName}}' ({{businessId}}). Ensure the system user belongs to this Business Manager. |
| 150120 | META_INTEGRATION_ACCESS_TOKEN_MISSING | 400 | Validation | org.errors.integrations.meta.integrationTokenMissing | Meta access token is missing. Connect a Meta account in the integration or submit a verified system user token for this ad account's business. |
| 150122 | META_INSIGHTS_ACCESS_MATRIX_DENIED | 400 | Validation | org.errors.integrations.meta.insights.accessMatrixPreflightDenied | No system user in the Meta access matrix can access ad account {{adAccountId}}. Open Organization → Integrations → Meta → Access matrix and re-verify, or grant system user access in Meta Business Manager. |
| 150123 | META_INSIGHTS_COVERAGE_GAP | 400 | Validation | org.errors.integrations.meta.insightsCoverage.gap | Meta insights data is incomplete for the requested date range. Missing days were detected on one or more ad accounts with daily sync enabled. Wait for gap-fill to finish or run a lifetime backfill. |
| 150124 | META_INSIGHTS_COVERAGE_WINDOW_UNRESOLVED | 400 | Validation | org.errors.integrations.meta.insightsCoverage.windowUnresolved | Cannot verify Meta insights coverage because the query date range could not be resolved. Pin a date range or use a supported time window. |
| 150125 | META_INSIGHTS_COVERAGE_ACCOUNT_INELIGIBLE | 400 | Validation | org.errors.integrations.meta.insightsCoverage.accountIneligible | One or more ad accounts in this query are not eligible for automated insights sync (sync disabled, missing timezone, or no resolvable integration). |
| 150126 | META_INSIGHTS_COVERAGE_NO_SYNC_TARGETS | 400 | Validation | org.errors.integrations.meta.insightsCoverage.noSyncTargets | No Meta ad accounts are eligible for insights sync in this organization, so warehouse reads cannot be verified. |
| 150208 | META_BACKFILL_ALREADY_IN_PROGRESS | 400 | Conflict | org.errors.integrations.meta.backfill.alreadyInProgress | Initial backfill already in progress or completed. It can only be triggered once per ad account. |
| 150209 | META_ATTRIBUTION_LOCKED | 400 | Conflict | org.errors.integrations.meta.attributionLocked | Attribution window cannot be changed after backfill has started. |
| 150227 | META_COVERAGE_GAP_SYNC_IN_PROGRESS | 400 | Conflict | org.errors.integrations.meta.coverageGapSync.inProgress | A coverage gap sync is already running for this ad account. Wait for it to finish or try again after 24 hours. |
| 150302 | META_AUTH_ERROR | 401 | Unauthorized | general.errors.unauthorized | Unauthorized |
| 150321 | META_INTEGRATION_OAUTH_SESSION_INVALIDATED | 401 | Unauthorized | org.errors.integrations.meta.oauth.sessionInvalidated | Your Meta access token is no longer valid. Reconnect the Meta integration to refresh your session. |
| 150503 | META_RATE_LIMIT | 429 | Rate Limit | general.errors.general | Error |
| 159901 | META_API_ERROR | 400 | Internal | general.errors.general | Error |
| 159905 | META_TRANSIENT_ERROR | 500 | Internal | general.errors.unexpected | Unexpected server error. We've been notified. |