Resolve OAuth authorization failures, expired tokens, and connection errors when connecting Shopify, Google, Meta, or other platforms to MerchantFlow.

Fix Integration Errors

Integration errors in MerchantFlow occur when connecting or maintaining OAuth-based connections to platforms like Shopify, Google, Meta, TikTok, or Snapchat. Most integration errors can be resolved by clearing your browser cache, verifying account permissions, or reconnecting the integration through Settings.

How to Fix OAuth Authorization Errors

"Authorization failed"

Causes:

Browser cache interfering with OAuth flow
Logged into the wrong account on the third-party platform
Insufficient permissions on the platform account
Third-party platform experiencing issues

Fix:

Clear your browser cache and cookies
Try an incognito/private browser window
Verify you are logged into the correct account (Google, Shopify, etc.)
Ensure you have admin access on the platform
Try again after a few minutes

"Access denied" or "Insufficient permissions"

Causes:

Your account does not have admin/owner access
Organization policies restrict third-party app access
Google Workspace admin has restricted OAuth apps

Fix:

Verify your role on the platform (must be Admin or Owner)
For Google Workspace: contact your IT admin to allow MerchantFlow
For Shopify: ensure you are the store owner or have full permissions

"Redirect URI mismatch"

Cause: Rare OAuth configuration issue.

Fix: Clear your browser cache completely and try again. If it persists, contact support at [email protected].

How to Fix Token Errors

"Token expired" or "Invalid token"

OAuth tokens should refresh automatically. If they do not:

Go to Settings > Integrations
Click "Reconnect" next to the affected integration
Complete the OAuth flow again
Data syncing resumes with no data loss

"Token revoked"

This means access was explicitly removed on the platform side:

Shopify -- the MerchantFlow app was uninstalled from the store
Google -- access was revoked in Google Account > Security > Third-party access
Meta -- app access was removed in Facebook Business Settings

Fix: Reconnect the integration through Settings > Integrations.

Understanding Health Status Error Types

MerchantFlow tracks integration health with these failure types:

Error Type	Description	Auto-Recovery
`token_expired`	OAuth token needs refresh	Usually automatic
`rate_limit`	API quota exceeded	Yes (backs off and retries)
`api_error`	Platform returned an error	Retries on next cycle
`timeout`	Request took too long	Retries on next cycle
`no_data`	Platform returned empty response	Check platform data
`partial`	Some data synced, some failed	Retries failed portions
`missing_credential`	No OAuth token stored	Requires reconnection
`network_error`	Connection failure	Usually resolves quickly

What Happens During Post-Connection Validation

After connecting an integration, MerchantFlow runs a validation check to ensure:

The OAuth token is valid and has correct scopes
The platform account/property is accessible
Basic data can be retrieved

If validation fails, you will see a specific error message. Common issues:

"No GA4 properties found" -- sign in with the account that owns the GA4 property
"No Merchant Center accounts" -- ensure you have admin access to Merchant Center
"Store not accessible" -- check that your Shopify store is active and not in maintenance mode

What Happens After Consecutive Failures

MerchantFlow tracks consecutive sync failures for each integration. After multiple failures:

You will receive an email notification about the issue
The integration status changes to "Error"
Syncing continues to retry on schedule
Once the issue is resolved, the failure counter resets

Frequently Asked Questions

Do I lose data when I reconnect an integration?

No. Reconnecting an integration refreshes the OAuth token but does not delete any previously synced data. Syncing resumes from where it left off.

Why does my Google integration keep disconnecting?

Common causes include password changes on your Google account, revoked third-party access in Google Security settings, or Google Workspace admin policies. Verify your Google account settings and reconnect.

Can I connect multiple Google accounts?

You connect to Google services using one Google account per workspace. That account must have access to the GA4 property, Search Console site, and Merchant Center account you want to sync.

How do I know if an integration error will resolve itself?

Check the Auto-Recovery column in the health status table above. Errors like rate_limit, api_error, and timeout typically resolve automatically. Errors like missing_credential require manual reconnection.

Troubleshooting Integrations -- Platform-specific troubleshooting
Sync Failures -- Data sync issues
Login Issues -- Account access problems
Connect Integrations -- Initial setup guide

Last updated: March 14, 2026

Fix Integration Errors in MerchantFlow