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

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

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: March 14, 2026