Getting started

Connect a client's sources

Connect a client's ad platforms, analytics, CRM and commerce tools to their Maven workspace, or send the client a connect link so they can authorize an account themselves.

Sources are the platforms Maven pulls a client's data from: ad platforms, analytics, CRM, commerce, email, SEO and more. You connect them per workspace, and Maven models the data into clean, documented tables you can report on. Most sources connect by signing in to the platform. Some ask for an API key or other credentials instead.

Connect a source#

  1. Select the client's workspace in the sidebar, then open Sources.
  2. Select Add a source and search for the platform, for example Google Ads, Facebook Ads, LinkedIn Ads, TikTok Ads, Google Analytics 4, HubSpot CRM or Shopify.
  3. Check What Maven will access, then select Connect followed by the platform name.
  4. Sign in to the platform in the window that opens and approve access. If nothing opens, allow pop-ups for Maven and try again.
  5. Choose the accounts to pull from, such as the ad account, GA4 property or CRM portal, and confirm your selection.

The source then appears in the Sources table with its Status, Result, Last sync and Schedule.

If you have already connected the same platform for another workspace, Maven may offer to reuse that sign-in. Each connection is labelled either Shared across your workspaces or This workspace. To add another account on a platform that is already connected, open it in Sources and select Add account.

Let the client authorize an account#

You might not have access to a client's account yourself. In that case, send the client a link and let them authorize it.

  1. In Sources, start connecting the platform for the client's workspace.
  2. Select Copy shareable connect link.
  3. Send the link to the client. They open it, sign in to the platform and choose the accounts. The connection is added to the workspace.

Connect links expire. If the client sees "This connect link has expired. Please request a new one.", copy a fresh link. Not every platform supports connect links. Maven tells you when one doesn't.

Connect the client's tag manager#

Maven works with Google Tag Manager and Piwik PRO Tag Manager. If the client uses Piwik PRO, connecting Piwik PRO as a source also covers its Tag Manager.

Connect Google Tag Manager the same way: Add a source, then Google Tag Manager. When you choose accounts, tick every GTM container the client's site uses. All containers share the same Google connection. See Tag management for what Maven does with it.

Manage a connection#

Open the actions menu on a source in the Sources table to:

  • Sync now: pull new data immediately.
  • Reauthenticate: sign in again when a platform's access has expired or been revoked.
  • Remove: disconnect the source and delete its connection data.

What happens next#

After you connect a source, Maven runs a first sync and builds the workspace's tables. This usually takes tens of minutes. You can start building reports once that finishes. If a first sync fails, the source shows the error in Sources, and you can reauthenticate or reconnect it.

You can also connect and check sources from Claude or ChatGPT through the MCP. The integration tool lists the available platforms, starts a connection and reports each source's readiness. See the MCP overview.

Next, set budgets and alerts for the workspace.

Last updated 2026-11-05