Connect Integrations to MerchantFlow

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.

Verify your email first. On the web app, the commerce and marketing onboarding steps are locked behind email verification, and the OAuth start endpoints reject unverified users. See Create Account.

What Integrations Does MerchantFlow Support?

MerchantFlow supports commerce platforms, Google services, advertising networks, and fulfillment providers. Guided onboarding runs seven steps in this order.

The completion screen then hands you two follow-up steps - tax (tax treatment and country rules) and north-star (choose your headline metrics) - before dropping you on the dashboard.

Shopify App Store installs skip commerce because the store is connected during install, so their counter reads six steps and starts at marketing.

After onboarding, the same workspace can be managed from:

• Settings > Integrations (Commerce, Marketing, Fulfilment, Audit Logs, System Health sections)
• Settings > Logs
• The Manual Sync Runner at the bottom of Settings > Integrations

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. MerchantFlow strips any https:// prefix and appends .myshopify.com if you only type the store handle
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. It asks "Do you use a 3PL for fulfillment?" and offers:

• SpeedFulfill - the one supported 3PL in the onboarding picker (marked Recommended). ShipBob, ShipStation, and Deliverr appear as Coming soon cards
• My 3PL is not listed - set fulfillment cost as a percentage of product cost (0.01 to 100)
• I pay my supplier directly - enter a per-unit fulfillment cost per product on the COGS page instead. This option is hidden while a 3PL connection is active
• Skipping the step and configuring fulfillment later from settings

Settings > Integrations supports more fulfilment providers than onboarding does: SpeedFulfill, CJ Dropshipping, and Gooten. None of the three is plan-gated -- they are available on every tier.

ShipMonk and Printful exist in the product but ship disabled. Each sits behind its own admin-controlled feature flag that is off for every workspace by default, so their cards do not appear in Settings > Integrations unless MerchantFlow enables them for your account. Plan tier makes no difference here -- the flag is checked on top of the plan.

For warehouse-level fulfillment data, see Speedfulfill Integration.

How to Connect Google Services

MerchantFlow uses a shared Google OAuth connection, shown on the onboarding card as Google Ecosystem. One Google authorization can unlock:

• GA4 (Google Analytics 4) - the default service, used for traffic and conversion data
• Google Ads - pick the Ads customer account you want to sync
• Search Console - organic search visibility data
• Merchant Center - Shopping feed health and disapprovals

Search Console and Merchant Center Are Off by Default

Search Console and Merchant Center are hidden for most workspaces. Both sit behind admin-controlled feature flags that are off by default while data quality is being stabilised, and both additionally require a Pro or Plus plan. When a flag is off, the service is stripped out of the Google card, the configuration modal, the navigation, and the API. Ask support if you need either enabled for your workspace.

Important: Configure Services After OAuth

Connecting Google is only the first step. After OAuth, MerchantFlow opens a modal - Select Your Google Accounts during onboarding, Configure Google Services from settings - where you choose the exact:

• GA4 property
• Google Ads customer account
• Search Console site (only when enabled for your workspace)
• Merchant Center account (only when enabled for your workspace)

During onboarding you must pick at least one account before Save will proceed, or use Skip for now to continue without Google. The modal also has a Reconnect with a different Google account link if you authorized with the wrong login.

Google Ads Account Selection

Google Ads has its own selector in the same modal, listing every Ads account reachable from the Google login you authorized. If the list comes back empty, MerchantFlow tells you so and points you at Connect a different Google account - that means the Google login you used has no Ads access, not that Google Ads is unavailable. The rest of the Google stack still connects and syncs normally.

How to Connect Ad Platforms

MerchantFlow currently supports four paid advertising platforms (Meta, Snapchat, TikTok, Google Ads) plus an owned-audience channel (Klaviyo).

The marketing onboarding step shows four cards: Google Ecosystem, Meta Ads, Snapchat Ads, and TikTok Ads. Klaviyo is not in onboarding - connect it from Settings > Integrations.

Meta Ads

Meta uses a two-part flow:

1. OAuth approval with Meta
2. Ad-account selection

The ad-account picker only appears automatically when your Meta login has two or more ad accounts. With a single account, MerchantFlow selects it during OAuth and you are done. You can change or add accounts later from Settings > Integrations > Configure Meta Ads.

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.

Klaviyo (Email and SMS)

Klaviyo is an owned-audience channel that brings email and SMS campaign performance into the marketing dashboard. Because it is a flat-fee subscription rather than per-send media, MerchantFlow tracks attributed revenue from Klaviyo while reporting $0 spend. Connect it from Settings > Integrations. See Klaviyo Integration for the full flow.

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 tenants do not connect a storefront on the agency workspace itself - agency and partner tenants are excluded from background syncs entirely.

Instead, agencies add client stores from Clients one of two ways:

• Invite by email - the brand owner approves the connection and keeps their own MerchantFlow subscription. Choose read or read_write permissions when sending the invite.
• Connect their Shopify - the agency installs the Shopify app themselves using collaborator access, and the store is provisioned and billed on the agency plan.

See Agency Workflows for the full process.

Recommended Integration Order

The guided flow already runs in the safest order:

1. Connect Shopify or WooCommerce
2. Connect Google (GA4 and Google Ads) and your ad platforms (Meta, Snapchat, TikTok)
3. Decide on fulfillment setup
4. Enter your bank balance and any external funding
5. Finish billing approval - this starts the 14-day trial clock
6. Confirm or skip the daily AI brief opt-in
7. Complete the tax and north star follow-up steps
8. Connect Klaviyo and any extra fulfilment providers from Settings > Integrations
9. 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, Google Ads account, Search Console site, or Merchant Center account. Use Reconnect with a different Google account in the modal to switch logins.

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 Google services enabled for your workspace, and every supported ad platform (Meta, Snapchat, TikTok) at once. Meta also supports multiple ad accounts under one connection. 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?

Two reasons. First, OAuth alone does not activate anything - you must open the account-selection modal and pick a property or account per service. Second, Search Console and Merchant Center are off by default for every workspace and only appear once MerchantFlow enables them for your account on a Pro or Plus plan.

Do I need to connect all integrations during onboarding?

No. Every integration step has a skip path, and you can connect the rest later from Settings > Integrations or the Setup Guide.

Related Guides

• Create Account - Sign up for MerchantFlow
• First Sync - What to expect after connecting integrations
• Dashboard Overview - Navigate your analytics dashboard
• Shopify - Detailed Shopify integration guide
• Google Analytics - GA4 setup and configuration
• Merchant Center - Google Merchant Center integration
• Meta Ads - Meta advertising setup
• Klaviyo - Email and SMS marketing analytics
• WooCommerce - WooCommerce REST API connection
• Troubleshooting Integrations - Fix common connection issues

---

Last updated: August 29, 2026