Cognis

Errors — Integration

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).

CodeKeyHTTPCategoryMessage keyMessage
60001SHOPIFY_SECRET_NOT_FOUND404Not Foundintegration.errors.shopifySecretNotFoundShopify secret not found
60003GOOGLE_DRIVE_FOLDER_NOT_FOUND404Not Foundintegration.errors.googledrive.folderNotFoundThe configured Google Drive folder could not be found. It may have been deleted or the connected account no longer has access. An admin should verify the brand folder configuration.
60006GOOGLE_DRIVE_BRAND_NOT_CONFIGURED404Not Foundintegration.errors.googledrive.brandNotConfiguredNo Google Drive folder is configured for this brand. An admin must assign a folder first.
60102INVALID_HMAC422Validationintegration.errors.invalidHMACInvalid HMAC
60110GOOGLE_ADS_DEVELOPER_TOKEN_NOT_CONFIGURED422Validationintegration.errors.googleads.developerTokenNotConfiguredThe Google Ads developer token is not configured for this environment. An administrator must set GOOGLE_ADS_DEVELOPER_TOKEN before listing accounts.
60111GOOGLE_ADS_REFRESH_TOKEN_REQUIRED422Validationintegration.errors.googleads.refreshTokenRequiredGoogle did not return a refresh token. Disconnect and connect again, and approve offline access when prompted.
60112GOOGLE_ADS_EMAIL_REQUIRED422Validationintegration.errors.googleads.emailRequiredGoogle did not return a valid email for this account. Try reconnecting and ensure you grant email access.
60114GOOGLE_ADS_API_ERROR422Validationintegration.errors.googleads.apiErrorGoogle Ads returned an error while loading accounts. Try again later or contact support if it continues.
60115GOOGLE_ADS_CUSTOMER_NOT_ACCESSIBLE422Validationintegration.errors.googleads.customerNotAccessibleOne or more customer IDs are not accessible with this Google Ads connection. Refresh the list from Google and try again.
60117GOOGLE_SEARCH_CONSOLE_REFRESH_TOKEN_REQUIRED422Validationintegration.errors.googlesearchconsole.refreshTokenRequiredGoogle did not return a refresh token. Disconnect and connect again, and approve offline access when prompted.
60118GOOGLE_SEARCH_CONSOLE_EMAIL_REQUIRED422Validationintegration.errors.googlesearchconsole.emailRequiredGoogle did not return a valid email for this account. Try reconnecting and ensure you grant email access.
60119GOOGLE_SEARCH_CONSOLE_API_ERROR422Validationintegration.errors.googlesearchconsole.apiErrorGoogle Search Console returned an error. Try again later or contact support if it continues.
60120GOOGLE_SEARCH_CONSOLE_PROPERTY_NOT_VERIFIED422Validationintegration.errors.googlesearchconsole.propertyNotVerifiedThe domain property is not verified in Google Search Console yet. Complete DNS verification and retry.
60122GOOGLE_ANALYTICS_4_REFRESH_TOKEN_REQUIRED422Validationintegration.errors.googleanalytics4.refreshTokenRequiredGoogle did not return a refresh token. Disconnect and reconnect with consent.
60123GOOGLE_ANALYTICS_4_EMAIL_REQUIRED422Validationintegration.errors.googleanalytics4.emailRequiredCould not read the Google account email. Try reconnecting.
60124GOOGLE_ANALYTICS_4_ORG_NOT_CONNECTED422Validationintegration.errors.googleanalytics4.orgNotConnectedConnect Google Analytics 4 under Org → Integrations before automatic setup.
60125GOOGLE_ANALYTICS_4_PROVISION_NOT_READY422Validationintegration.errors.googleanalytics4.provisionNotReadyAutomatic GA4 setup is not available yet in this environment.
60126GOOGLE_ANALYTICS_4_MEASUREMENT_ID_INVALID422Validationintegration.errors.googleanalytics4.measurementIdInvalidInvalid Measurement ID. Use the G- prefix format from GA4.
60128GOOGLE_MERCHANT_CENTER_REFRESH_TOKEN_REQUIRED422Validationintegration.errors.googlemerchantcenter.refreshTokenRequiredGoogle did not return a refresh token. Disconnect and reconnect with consent.
60129GOOGLE_MERCHANT_CENTER_EMAIL_REQUIRED422Validationintegration.errors.googlemerchantcenter.emailRequiredCould not read the Google account email. Try reconnecting.
60130GOOGLE_MERCHANT_CENTER_ORG_NOT_CONNECTED422Validationintegration.errors.googlemerchantcenter.orgNotConnectedConnect Google Merchant Center at the organisation level before provisioning a brand sub-account.
60131GOOGLE_MERCHANT_CENTER_PROVISION_NOT_READY422Validationintegration.errors.googlemerchantcenter.provisionNotReadyBrand sub-account provisioning is not available yet in this environment.
60132GOOGLE_MERCHANT_CENTER_MCA_NOT_ADVANCED422Validationintegration.errors.googlemerchantcenter.mcaNotAdvancedYour Merchant Center account must be an Advanced Account (MCA) before Cognis can create brand sub-accounts.
60133GOOGLE_MERCHANT_CENTER_MCA_NOT_RESOLVED422Validationintegration.errors.googlemerchantcenter.mcaNotResolvedCould not detect your Merchant Center account from Google. Re-authorize the connection or use Refresh account status on the org integration page.
60134CLOUDFLARE_TOKEN_INVALID_OR_INACTIVE422Validationintegration.errors.cloudflare.tokenInvalidOrInactiveThis Cloudflare API token is missing, invalid, revoked, or not active. Create a new token and try again.
60135CLOUDFLARE_TOKEN_AUTH_REJECTED422Validationintegration.errors.cloudflare.tokenAuthRejectedCloudflare returned HTTP 401 or 403 when Cognis used this Bearer token (we call list zones plus read the account summary). Paste the full Account API Token from Manage Account → Account API Tokens—one-time secret, often cfat_, with no spaces or quotes—not the Global API Key or Email + Global Key. The token needs at least Zone → Zone Settings → Read and Account → Account Settings → Read for the account whose ID you pasted.
60136CLOUDFLARE_TOKEN_DISABLED_OR_EXPIRED422Validationintegration.errors.cloudflare.tokenDisabledOrExpiredThis API token is disabled or expired in Cloudflare. Enable it in the dashboard or create a new token, then try again.
60137CLOUDFLARE_TOKEN_VERIFY_FAILED422Validationintegration.errors.cloudflare.tokenVerifyFailedCloudflare could not verify this token: {{detail}}
60138CLOUDFLARE_TOKEN_VERIFY_FAILED_GENERIC422Validationintegration.errors.cloudflare.tokenVerifyFailedGenericCloudflare could not verify this token. Prefer an Account API Token from Manage Account → Account API Tokens (Bearer), not the Global API Key, and paste the full token with no extra spaces. Then try again under Organization → Integrations → Cloudflare.
60139CLOUDFLARE_ZONE_NOT_FOUND422Validationintegration.errors.cloudflare.zoneNotFoundNo Cloudflare zone found for that domain with this token. Check the zone name, that the token can read the zone, and that the zone is in this account.
60140CLOUDFLARE_ZONE_AMBIGUOUS422Validationintegration.errors.cloudflare.zoneAmbiguousMultiple zones matched that name. Use a more specific zone name (exact Cloudflare zone root) or narrow which account the token can access.
60141CLOUDFLARE_ZONE_NOT_ACTIVE422Validationintegration.errors.cloudflare.zoneNotActiveThat Cloudflare zone is not active yet (for example pending or moved). Activate the zone in Cloudflare, then try again.
60144CLOUDFLARE_API_ERROR422Validationintegration.errors.cloudflare.apiErrorCloudflare returned an error while verifying the connection. Try again later or contact support if it continues.
60146CLOUDFLARE_OLD_ZONE_CLEANUP_FAILED422Validationintegration.errors.cloudflare.oldZoneCleanupFailedCognis could not remove checkout redirect rules from your previous Cloudflare zone with this token. Use a token that still has Single Redirect write access on the old zone, remove the old zone’s `cognis_chk_*` rules manually, then save again—or temporarily reconnect with a broader token.
60147CLOUDFLARE_ACCOUNT_ID_MISMATCH422Validationintegration.errors.cloudflare.accountIdMismatchThat Account ID does not match this token’s Cloudflare account (or the token cannot read that account). Copy the Account ID from the dashboard sidebar for the same account where you created this token, grant Account → Account Settings → Read if needed, then try again.
60148STOREFRONT_CHECKOUT_HTTP_BLOCKED400Validationintegration.errors.storefrontCheckout.httpBlockedStorefront checkout must use https unless your administrator explicitly allows http. Switch to https or ask an admin to enable the exception.
60149STOREFRONT_CHECKOUT_URL_PARSE_ERROR400Validationintegration.errors.storefrontCheckout.urlParseErrorThat value is not a valid URL. Enter a full address starting with https:// (for example https://shop.example.com).
60150STOREFRONT_CHECKOUT_URL_USERINFO_NOT_ALLOWED400Validationintegration.errors.storefrontCheckout.urlUserinfoNotAllowedThe URL must not include a username or password. Use a plain https address only.
60151STOREFRONT_CHECKOUT_REQUIRES_SHOPIFY_INTEGRATION400Validationintegration.errors.storefrontCheckout.requiresShopifyIntegrationConnect an active Shopify store to this brand (with a saved access token) before setting a storefront checkout URL.
60152STOREFRONT_CHECKOUT_SHOPIFY_DOMAIN_FETCH_FAILED400Validationintegration.errors.storefrontCheckout.shopifyDomainFetchFailedWe could not load this store's domain list from Shopify. Check the Shopify connection under brand integrations and try again. If it keeps failing, reconnect Shopify or contact support.
60153STOREFRONT_CHECKOUT_HOSTNAME_NOT_IN_SHOPIFY400Validationintegration.errors.storefrontCheckout.hostnameNotInShopifyThat hostname ({{host}}) is not on Shopify's list for this store. Add or verify the domain in Shopify admin, or use a hostname Shopify already recognizes.
60154STOREFRONT_CHECKOUT_CLOUDFLARE_HOST_UNSAFE400Validationintegration.errors.storefrontCheckout.cloudflareHostUnsafeThat hostname cannot be used with automated Cloudflare checkout protection. Use a normal DNS hostname.
60155STOREFRONT_CHECKOUT_CLOUDFLARE_INVALID_HOST400Validationintegration.errors.storefrontCheckout.cloudflareInvalidHostThat hostname is not valid for resolving your storefront's main site address. Correct the hostname and try again.
60156STOREFRONT_CHECKOUT_CLOUDFLARE_NOT_CONNECTED400Validationintegration.errors.storefrontCheckout.cloudflareNotConnectedSave a storefront checkout URL only after the Cognis Cloudflare integration is connected for this organization (Organization → Integrations → Cloudflare).
60157STOREFRONT_CHECKOUT_CLOUDFLARE_META_INCOMPLETE400Validationintegration.errors.storefrontCheckout.cloudflareMetaIncompleteThe Cloudflare integration is missing required data (verified token and 32-character Account ID from the dashboard sidebar). Open Organization → Integrations → Cloudflare and save both again.
60158STOREFRONT_CHECKOUT_CLOUDFLARE_ZONE_MISMATCH400Validationintegration.errors.storefrontCheckout.cloudflareZoneMismatchThe checkout hostname {{checkoutHost}} does not match the Cloudflare zone Cognis resolved for it ({{zoneName}}). Check the hostname, your token’s zone access, and DNS.
60161STOREFRONT_CHECKOUT_CLOUDFLARE_DNS_LIST_FAILED422Validationintegration.errors.storefrontCheckout.cloudflareDnsListFailedCloudflare did not allow reading DNS records for this zone. Confirm the API token includes DNS read access for the zone, then try again.
60162STOREFRONT_CHECKOUT_CLOUDFLARE_DNS_CREATE_FAILED422Validationintegration.errors.storefrontCheckout.cloudflareDnsCreateFailedCloudflare did not allow creating the checkout DNS record. Confirm the token can edit DNS for this zone, then try again.
60163STOREFRONT_CHECKOUT_CLOUDFLARE_DNS_PATCH_FAILED422Validationintegration.errors.storefrontCheckout.cloudflareDnsPatchFailedCloudflare did not allow updating the checkout DNS record. Confirm the token can edit DNS for this zone, then try again.
60168STOREFRONT_CHECKOUT_CLOUDFLARE_RULES_PUT_FAILED422Validationintegration.errors.storefrontCheckout.cloudflareRulesPutFailedCloudflare did not accept the redirect rule needed for this checkout host. Check token permissions for Single Redirects and try again.
60169STOREFRONT_CHECKOUT_CLOUDFLARE_TOKEN_AUTH_REJECTED422Validationintegration.errors.storefrontCheckout.cloudflareTokenAuthRejectedCloudflare rejected this token while saving checkout DNS or redirect rules (unauthorized or forbidden). Use an API Token from My Profile → API Tokens with Bearer auth—not the Global API Key—and reconnect under Organization → Integrations → Cloudflare.
60170STOREFRONT_CHECKOUT_CLOUDFLARE_TOKEN_DISABLED_OR_EXPIRED422Validationintegration.errors.storefrontCheckout.cloudflareTokenDisabledOrExpiredThe Cloudflare API token is disabled or expired. Enable it in Cloudflare or create a new token with the required permissions, then reconnect under Organization → Integrations → Cloudflare.
60171STOREFRONT_CHECKOUT_CLOUDFLARE_TOKEN_VERIFY_FAILED422Validationintegration.errors.storefrontCheckout.cloudflareTokenVerifyFailedCloudflare did not accept this token while saving checkout: {{detail}} Reconnect under Organization → Integrations → Cloudflare if the problem persists.
60172STOREFRONT_CHECKOUT_CLOUDFLARE_TOKEN_VERIFY_FAILED_GENERIC422Validationintegration.errors.storefrontCheckout.cloudflareTokenVerifyFailedGenericCloudflare did not accept this token while saving checkout DNS or redirect rules. Use a valid API Token (Bearer) with zone and Single Redirect permissions, and reconnect under Organization → Integrations → Cloudflare.
60173STOREFRONT_CHECKOUT_CLOUDFLARE_TOKEN_INVALID_OR_INACTIVE422Validationintegration.errors.storefrontCheckout.cloudflareTokenInvalidOrInactiveThe Cloudflare API token is missing, invalid, revoked, or inactive. Create a new token with the required permissions and reconnect Cloudflare.
60174WORDPRESS_AUTH_REJECTED422Validationintegration.errors.wordpress.authRejectedWordPress rejected the credentials. Re-check the site URL, username, and Application Password (must be created under WP Admin → Users → Profile → Application Passwords).
60175WORDPRESS_BASE_URL_INVALID422Validationintegration.errors.wordpress.baseUrlInvalidWordPress base URL is invalid. It must be a public https URL pointing to your site root (e.g. https://example.com), not the /wp-admin or /wp-json path.
60176WORDPRESS_API_ERROR422Validationintegration.errors.wordpress.apiErrorWordPress returned an unexpected error. Check the WP REST API is reachable and not blocked by a security plugin or hosting firewall.
60177WORDPRESS_BRAND_NOT_MAPPED400Validationintegration.errors.wordpress.brandNotMappedThis brand has no mapped WordPress site on this connection. Open the integration → Manage brand sites and assign a site for this brand first.
60178WORDPRESS_MEDIA_UPLOAD_FAILED422Validationintegration.errors.wordpress.mediaUploadFailedWordPress refused the media upload. Make sure the user has the upload_files capability and that the file size is below the host’s upload limit.
60179STRIPE_SECRET_AUTH_REJECTED422Validationintegration.errors.stripe.secretAuthRejectedStripe refused this secret key (unauthorized). Check that you pasted the full restricted secret key and that it is active.
60181STRIPE_API_ERROR422Validationintegration.errors.stripe.apiErrorStripe could not verify this key (network, timeout, or unexpected response). Check the key and try again.
60182STRIPE_ACCOUNT_ALREADY_LINKED422Validationintegration.errors.stripe.accountAlreadyLinkedThis Stripe account is already linked to another integration row on this organization. Update that connection or remove the duplicate before rotating this row to the same account.
60183STRIPE_INTEGRATION_ROW_ID_REQUIRED422Validationintegration.errors.stripe.integrationRowIdRequiredThis organization has multiple Stripe connections. Open the row you are updating in Cognis and save again so we know which connection to update, or use the API field integrationId with that row’s Sid.
60184SUPABASE_STORAGE_PROJECT_URL_INVALID422Validationintegration.errors.supabaseStorage.projectUrlInvalidSupabase project URL is invalid. Use your project URL from the dashboard, e.g. https://your-ref.supabase.co.
60185SUPABASE_STORAGE_AUTH_REJECTED422Validationintegration.errors.supabaseStorage.authRejectedSupabase rejected the service role key (unauthorized). Check that you pasted the full service role secret from Project Settings → API.
60186SUPABASE_STORAGE_API_ERROR422Validationintegration.errors.supabaseStorage.apiErrorCould not reach Supabase with these credentials (network, timeout, or unexpected response). Check the project URL and key, then try again.
60187PORKBUN_AUTH_REJECTED422Validationintegration.errors.porkbun.authRejectedPorkbun rejected these credentials. Check your API key and secret key in Porkbun → Account → API Access, then try again.
60188PORKBUN_API_ERROR422Validationintegration.errors.porkbun.apiErrorCould not reach Porkbun. Check your network connection and try again.
60189AIRWALLEX_AUTH_REJECTED422Validationintegration.errors.airwallex.authRejectedAirwallex rejected these credentials. Check your Client ID and API key, then try again.
60190AIRWALLEX_API_ERROR422Validationintegration.errors.airwallex.apiErrorCould not reach Airwallex. Check your network connection and try again.
60191AIRWALLEX_MISSING_REQUIRED_SCOPES422Validationintegration.errors.airwallex.missingRequiredScopesThis API key is missing required scope(s): {{scopes}}. Enable Account Read, Payment Acceptance Read + Write, Payment Disputes Read, and Webhooks Read + Write (Global permissions) on the scoped key in Airwallex, then try again.
60192AIRWALLEX_ACCOUNT_ALREADY_LINKED422Validationintegration.errors.airwallex.accountAlreadyLinkedThis Airwallex Client ID is already connected for this organization.
60193KLAVIYO_AUTH_REJECTED422Validationintegration.errors.klaviyo.authRejectedKlaviyo rejected this private API key. Check the key in Klaviyo → Settings → API keys, then try again.
60194KLAVIYO_API_ERROR422Validationintegration.errors.klaviyo.apiErrorCould not reach Klaviyo. Check your network connection and try again.
60195KLAVIYO_ACCOUNT_ALREADY_LINKED422Validationintegration.errors.klaviyo.accountAlreadyLinkedThis Klaviyo account is already connected under a different integration row in this organization.
60196KLAVIYO_MISSING_REQUIRED_SCOPES422Validationintegration.errors.klaviyo.missingRequiredScopesThis private API key is missing required scope(s). Enable Accounts Read, Lists Read, and Events Write on a new Custom private key in Klaviyo → Settings → API keys, then try again.
60197KLAVIYO_RATE_LIMITED422Validationintegration.errors.klaviyo.rateLimitedKlaviyo rate-limited this request. Wait a moment and try again.
60198KLAVIYO_MULTIPLE_ACCOUNTS422Validationintegration.errors.klaviyo.multipleAccountsThis API key returned more than one Klaviyo account. Use a key scoped to a single account.
60404GOOGLE_DRIVE_ACCESS_DENIED403Forbiddenintegration.errors.googledrive.accessDeniedThe organisation's Google Drive connection was denied access. An admin should verify the integration is still authorised.
60405GOOGLE_DRIVE_USER_NOT_CONNECTED403Forbiddenintegration.errors.googledrive.userNotConnectedPlease connect your Google Drive account before uploading files.
60407GOOGLE_DRIVE_ORG_TOKEN_MISSING403Forbiddenintegration.errors.googledrive.orgTokenMissingThe organisation's Google Drive connection has expired. An admin must reconnect Google Drive.
60408GOOGLE_DRIVE_USER_TOKEN_MISSING403Forbiddenintegration.errors.googledrive.userTokenMissingYour Google Drive session has expired. Please reconnect your Google Drive account.
60409GOOGLE_DRIVE_USER_NO_FOLDER_ACCESS403Forbiddenintegration.errors.googledrive.userNoFolderAccessYour connected Google account does not have access to this brand's Drive folder. Make sure the correct Google account is connected in your Account Preferences, and that an admin has granted it access to the folder.
60413GOOGLE_ADS_SCOPE_INSUFFICIENT403Forbiddenintegration.errors.googleads.scopeInsufficientGoogle Ads access was not granted. Approve all requested permissions, including Google Ads API access, and try again.
60416GOOGLE_SEARCH_CONSOLE_SCOPE_INSUFFICIENT403Forbiddenintegration.errors.googlesearchconsole.scopeInsufficientSearch Console access was not granted. Approve all requested permissions, including webmasters and site verification, and try again.
60421GOOGLE_ANALYTICS_4_SCOPE_INSUFFICIENT403Forbiddenintegration.errors.googleanalytics4.scopeInsufficientGoogle account did not grant Analytics edit access. Reconnect and approve all requested permissions.
60427GOOGLE_MERCHANT_CENTER_SCOPE_INSUFFICIENT403Forbiddenintegration.errors.googlemerchantcenter.scopeInsufficientGoogle account did not grant Merchant Center access. Reconnect and approve all requested permissions.
60442CLOUDFLARE_RULES_PROBE_FORBIDDEN403Forbiddenintegration.errors.cloudflare.rulesProbeForbiddenThis token cannot read Single Redirect rules for that zone. Grant Zone → Dynamic URL Redirects (Write) for Single Redirects on the zone, plus zone read access, then try again.
60443CLOUDFLARE_DNS_PROBE_FORBIDDEN403Forbiddenintegration.errors.cloudflare.dnsProbeForbiddenThis token cannot read DNS records for that zone. Grant Zone → DNS → Edit and zone read for the zone so Cognis can add Mailgun email records and checkout DNS, then try again.
60459STOREFRONT_CHECKOUT_CLOUDFLARE_TOKEN_MISSING403Forbiddenintegration.errors.storefrontCheckout.cloudflareTokenMissingThe Cloudflare integration has no saved API token. Reconnect Cloudflare with a valid token.
60466STOREFRONT_CHECKOUT_CLOUDFLARE_RULES_FORBIDDEN403Forbiddenintegration.errors.storefrontCheckout.cloudflareRulesForbiddenThe Cloudflare API token cannot read or write Single Redirect rules for this zone. Update the token (Dynamic URL Redirects / Single Redirects for the zone), then try again.
60545CLOUDFLARE_RATE_LIMITED429Rate Limitintegration.errors.cloudflare.rateLimitedCloudflare rate-limited this request. Wait a minute and try again.
60565STOREFRONT_CHECKOUT_CLOUDFLARE_RATE_LIMITED429Rate Limitintegration.errors.storefrontCheckout.cloudflareRateLimitedCloudflare rate-limited this save. Wait a short time and try again.
60580STRIPE_RATE_LIMITED429Rate Limitintegration.errors.stripe.rateLimitedStripe rate-limited the verification request. Wait a moment and try again.
69960STOREFRONT_CHECKOUT_CLOUDFLARE_TOKEN_DECRYPT_FAILED500Internalintegration.errors.storefrontCheckout.cloudflareTokenDecryptFailedThe saved Cloudflare token could not be read. Reconnect Cloudflare.
69964STOREFRONT_CHECKOUT_CLOUDFLARE_RULES_TRANSPORT500Internalintegration.errors.storefrontCheckout.cloudflareRulesTransportWe could not reach Cloudflare to update redirect rules. Check connectivity and try again.
69967STOREFRONT_CHECKOUT_CLOUDFLARE_RULES_LOAD_FAILED500Internalintegration.errors.storefrontCheckout.cloudflareRulesLoadFailedCloudflare returned an error while loading redirect rules for this zone. Try again later or reconnect Cloudflare.