MerchantFlowMerchantFlow Docs
Getting Started

Connect Integrations to MerchantFlow

Connect Shopify, WooCommerce, Google Analytics, Meta Ads, TikTok Ads, and fulfillment services to MerchantFlow for unified e-commerce analytics.

Connect Integrations to MerchantFlow

MerchantFlow integrations connect your e-commerce platform, Google services, advertising channels, and fulfillment providers into a single analytics dashboard. You can connect integrations during the guided onboarding flow or later from Settings > Integrations.

What Integrations Does MerchantFlow Support?

MerchantFlow supports commerce platforms, Google services, advertising networks, and fulfillment providers. The table below maps each integration to its onboarding step.

Onboarding StepMain Purpose
commerceConnect Shopify or WooCommerce
fulfillmentSet a fulfillment percentage or prepare for a 3PL workflow
marketingConnect Google, Meta, Snapchat, and TikTok
paymentFinish billing approval for a live workspace

After onboarding, the same workspace can be managed from:

  • Settings > Integrations
  • Settings > Logs
  • Manual Sync Runner

How to Connect a Commerce Platform

Every live merchant workspace needs one primary commerce platform. MerchantFlow supports one commerce connection per tenant.

How to Connect Shopify

Use Shopify when you:

  • Connect from the web app onboarding flow
  • Connect later from settings
  • Are not already using the embedded Shopify App Store install

Connection flow:

  1. Go to /onboarding/commerce or Settings > Integrations
  2. Select Shopify
  3. Enter the .myshopify.com store domain
  4. Approve Shopify OAuth
  5. Return to MerchantFlow

For the embedded install path, see Shopify App Store.

How to Connect WooCommerce

Use WooCommerce when you manage a self-hosted WooCommerce store and can create REST credentials.

Connection flow:

  1. Go to /onboarding/commerce or Settings > Integrations
  2. Select WooCommerce
  3. Enter the store URL
  4. Enter the consumer key
  5. Enter the consumer secret
  6. Save the connection

MerchantFlow expects HTTPS and read-capable REST credentials. For detailed setup, see WooCommerce Integration.

Switching Between Shopify and WooCommerce

MerchantFlow only supports one primary commerce platform per merchant tenant. If you need to switch, disconnect the current commerce platform first from Settings > Integrations.

How to Set Up Fulfillment Tracking

The fulfillment step is where you define how MerchantFlow should account for delivery and 3PL costs.

Current options include:

  • A percentage-based fulfillment assumption (simplest live setup)
  • Leaving fulfillment unset for now
  • Connecting a supported 3PL later from settings

For warehouse-level fulfillment data, see Speedfulfill Integration.

How to Connect Google Services

MerchantFlow uses a shared Google OAuth connection. One Google authorization can unlock:

  • GA4 (Google Analytics 4)
  • Search Console
  • Merchant Center
  • Google Ads

Important: Configure Services After OAuth

Connecting Google is only the first step. After OAuth, open Configure Google Services and choose the exact:

  • GA4 property
  • Search Console site
  • Merchant Center account
  • Google Ads customer account, if available

Google Ads Availability

Google Ads is conditional on environment configuration. If the Google configuration modal shows Coming Soon for Google Ads, your MerchantFlow environment is not currently configured for Google Ads sync. The rest of the Google stack can still be connected and used normally.

How to Connect Ad Platforms

MerchantFlow currently supports three advertising platforms:

Meta Ads

Meta uses a two-part flow:

  1. OAuth approval with Meta
  2. Ad-account selection in the Meta configuration step

For detailed setup, see Meta Ads Integration.

Snapchat Ads and TikTok Ads

These flows are provider OAuth connections launched from the marketing step or from Settings > Integrations. See Snapchat Ads and TikTok Ads for details.

How to Connect Speedfulfill and 3PL

MerchantFlow also supports Speedfulfill for supported fulfillment workflows.

Use it when:

  • You want fulfillment-aware syncs beyond a flat percentage
  • Your warehouse operations already run through Speedfulfill

Integration Setup for Agency and Partner Tenants

Agency-style tenants generally do not connect a storefront directly on the agency workspace itself.

Instead, agencies:

  1. Invite brands from Clients
  2. Choose read or read_write permissions
  3. Wait for the merchant to approve the relationship
  4. Switch into the connected merchant workspace when active

See Agency Workflows for the full process.

Recommended Integration Order

For most merchants, this is the safest order for connecting integrations:

  1. Connect Shopify or WooCommerce
  2. Decide on fulfillment setup
  3. Connect Google services
  4. Connect ad platforms
  5. Finish billing approval
  6. Review the first sync

Common Integration Setup Mistakes

Wrong Google Account

The most common Google issue is authenticating with an account that can sign in but cannot actually access the property or account you need. Verify your Google account has admin or standard access to the specific GA4 property, Search Console site, or Merchant Center account.

Wrong Commerce Domain

For Shopify, use the .myshopify.com domain. For WooCommerce, use the store URL with HTTPS.

Half-Finished Connection

OAuth approval alone is not enough for Google or Meta. You still need to select the property or ad account after the provider returns to MerchantFlow.

Frequently Asked Questions

How many integrations can I connect to MerchantFlow?

You can connect one commerce platform (Shopify or WooCommerce), all supported Google services, and multiple ad platforms (Meta, Snapchat, TikTok) simultaneously. There is no limit on the number of marketing integrations.

Can I reconnect an integration without losing data?

Yes. Disconnecting and reconnecting an integration refreshes the OAuth credentials. Your historical synced data is preserved in MerchantFlow.

Why is my Google integration not showing all services?

After completing Google OAuth, you must open Configure Google Services and select each specific property or account. OAuth alone does not activate individual services.

Do I need to connect all integrations during onboarding?

No. You can skip integrations during onboarding and connect them later from Settings > Integrations or the Setup Guide.

Related Guides


Last updated: March 14, 2026