Troubleshooting MerchantFlow Integrations

This guide covers common integration issues and how to fix them when a connection will not start, fails during OAuth, or begins showing stale data. Use these platform-specific checks to diagnose and resolve problems quickly. For sync-specific issues after a successful connection, see Sync Troubleshooting.

Google Services Issues

No Properties or Sites Appear in Configure Google Services

• Reconnect with the correct Google account -- the connected Google user must have access to the properties you expect to see
• Confirm the account can access the GA4 property, Search Console site, or Merchant Center account
• If you recently changed Google account permissions, reconnect Google from Settings > Integrations

Google Ads Shows "Coming Soon"

This means your MerchantFlow environment is not currently configured for Google Ads sync. The rest of the Google stack (GA4, Search Console, Merchant Center) can still be connected and used normally.

Shopify Issues

OAuth Will Not Start

• Confirm the store domain is a valid .myshopify.com address
• Make sure you are an admin on the Shopify store
• Confirm your MerchantFlow account has verified email and 2FA enabled (Security Settings)

Shopify and WooCommerce Conflict

MerchantFlow allows one primary commerce platform per merchant tenant. If you see an error about a conflicting commerce connection, disconnect the existing platform from Settings > Integrations before connecting the new one. See Shopify or WooCommerce for platform-specific instructions.

WooCommerce Issues

API Credentials Fail

• Confirm the store URL is correct, reachable, and uses HTTPS
• Confirm the consumer key and consumer secret are valid
• Confirm the API key has read access permissions
• Regenerate credentials in WooCommerce > Settings > Advanced > REST API if needed

See WooCommerce Integration for full setup instructions.

Meta, Snapchat, or TikTok Issues

OAuth Was Cancelled or Interrupted

Restart the connection from Settings > Integrations. MerchantFlow does not save a partial connection if the provider flow is cancelled. You must complete the full OAuth flow for the connection to activate.

No Ad Accounts Appear After OAuth

• Confirm your advertising platform login has ad account access (check Meta Business Manager, Snapchat Ads Manager, or TikTok Ads Manager)
• Confirm the MerchantFlow environment has the platform enabled (some platforms are environment-gated)
• Reconnect the platform after fixing provider-side account access

Stale-Data Notifications and Disabled Integrations

MerchantFlow proactively watches every connected integration for stale data: a connection that authenticates successfully but has stopped returning new rows for longer than its expected refresh cadence. When stale data is detected, you will receive an in-app notification (and an email if you have notifications enabled) explaining which integration is affected and what changed.

Common triggers:

• The integration token was silently revoked on the provider side (Meta and Snapchat both expire tokens periodically without warning the connected app)
• The ad account was paused or moved to a different parent account
• The Shopify or WooCommerce store entered maintenance mode
• A configured property or account was deleted in the provider

Disabled Integrations Trigger Notifications

If an integration is manually disabled by an admin (for example, from the team settings page when there is a billing or compliance concern), MerchantFlow surfaces a clear notification so other workspace members know the disablement is intentional, not a sync failure. The dashboard data quality badges also reflect the disabled state.

How to Resolve a Stale Notification

1. Open the affected integration from Settings > Integrations
2. If the status is Token expired or Disconnected, click Reconnect and walk through OAuth again
3. If the status is Stale - no data returned, check the provider for paused ad accounts or empty date ranges, then trigger a manual sync
4. If the status is Disabled by admin, contact the workspace owner

The notification clears automatically on the next successful sync.

General Troubleshooting Steps

If none of the above fixes apply:

1. Check that your MerchantFlow account meets the OAuth prerequisites -- verified email and 2FA
2. Try disconnecting and reconnecting the integration from Settings > Integrations
3. Run a targeted manual sync from Settings > Integrations > Manual Sync Runner
4. Review Sync Troubleshooting if the connection is live but data looks wrong
5. Check Sync Status for error messages or failed sync indicators

Frequently Asked Questions

What is a "stale data" notification and what should I do?

MerchantFlow tags an integration as stale when it authenticates successfully but has stopped returning new rows for longer than its expected cadence. Reconnect the integration from Settings > Integrations to refresh credentials. If reconnecting does not resolve it, the data gap is usually on the provider side (paused ad account, deleted property, store maintenance).

Why does my integration keep disconnecting?

Integration disconnections usually happen when provider-side credentials expire or are revoked. For OAuth connections (Google, Shopify, Meta, TikTok, Snapchat), re-authorize from Settings > Integrations. For WooCommerce, regenerate your API credentials.

How do I know if my integration is connected and working?

Check Settings > Integrations for connection status indicators. A successfully connected integration shows an active status. You can also verify by checking Sync Status for recent successful syncs.

Can I reconnect an integration without losing historical data?

Yes. MerchantFlow retains your historical data when an integration is disconnected. Reconnecting resumes syncing from where it left off.

Related Guides

• Integrations Overview -- all supported integrations
• Shopify -- Shopify connection guide
• WooCommerce -- WooCommerce connection guide
• Sync Status -- monitor sync health
• Sync Troubleshooting -- fix sync-specific issues
• Manual Sync -- trigger syncs on demand

---

Last updated: May 23, 2026