Skip to main content
View .mdOpen in ClaudeOpen in ChatGPT

Providers

Providers are the external accounts FunnelFizz reads data from. This page is the complete reference for every supported provider: what it is, what permissions it needs, what data you get, and where it feeds into your funnel.

For the quickstart-level walkthrough, see Quickstart → Connect providers.

The roster​

ProviderAuthPlanStagesRefresh
X (Twitter)OAuth 2.0FREEAWARENESS30 min
YouTubeOAuth 2.0FREEAWARENESS30 min
LinkedInOAuth 2.0FREEAWARENESS30 min
InstagramOAuth 2.0FREEAWARENESS30 min
TikTokOAuth 2.0FREEAWARENESS30 min
RedditOAuth 2.0HOBBYAWARENESS30 min
Google Search ConsoleOAuth 2.0HOBBYAWARENESS60 min
Google AdsOAuth 2.0HOBBYAWARENESS60 min
StripeAPI key / AppFREETRIAL, CUSTOMER15 min + webhooks

All OAuth providers are read-only. FunnelFizz never posts, advertises, or modifies data on your behalf.

How connecting works (common flow)​

  1. Go to your funnel's stage → Connect provider, or Settings → Integrations → [Provider].
  2. Click Connect [Provider].
  3. Provider OAuth page opens. Review the read-only permissions. Click Allow.
  4. You're redirected back with a green checkmark.

Behind the scenes:

  • A single-use CSRF nonce is generated and embedded in the state parameter.
  • The OAuth code is exchanged for access + refresh tokens.
  • Tokens are encrypted with AES-256 at rest, scoped to your workspace.
  • A background sync job runs immediately to pull your recent metrics.

Workspace-wide, reusable across funnels​

Connected providers belong to your workspace, not a specific funnel. Connect X once, and every funnel in the workspace can attribute X impressions without re-authenticating. On the connect screen for any new funnel, you'll see a "Reuse existing" option.

Each stage links to a provider via a connections[] array — so a single provider can power multiple stages across multiple funnels simultaneously.

X (Twitter)​

Scopes requested: tweet.read, users.read, follows.read, offline.access.

Data you get:

  • Post impressions (past 28 days)
  • Likes, reposts, replies, bookmarks, quotes
  • Follower counts (current + daily change)
  • Top posts by impression (top 10)

How it feeds AWARENESS: total post impressions in the period become your AWARENESS metric (or contribute to it, if you have other providers too).

Gotchas:

  • X's free API tier has tight rate limits. For high-traffic accounts, you may hit 15-minute cooldowns. FunnelFizz handles rate limiting gracefully and retries on the next sync.
  • Premium X accounts get more granular post-level metrics via the v2 API.

YouTube​

Scopes requested: youtube.readonly, yt-analytics.readonly.

Data you get:

  • Total video views (rolling 28 days)
  • Subscriber count
  • Watch time (hours)
  • Top videos by views

How it feeds AWARENESS: video views contribute to AWARENESS impressions.

LinkedIn​

Scopes requested: r_organization_social, r_liteprofile, w_member_social (read only — the "w_" scope is LinkedIn's naming quirk; we do not post).

Data you get:

  • Post impressions
  • Reactions, comments, shares
  • Follower growth
  • Top posts

Gotchas:

  • LinkedIn distinguishes personal profiles from company pages. You'll pick which one to connect during OAuth. To track both, connect each separately.

Instagram​

Scopes requested: user_profile, user_media, instagram_basic.

Data you get:

  • Post reach and impressions
  • Engagement (likes, comments, saves, shares)
  • Follower count
  • Top posts

Gotchas:

  • Instagram Business or Creator accounts only. Personal accounts don't expose the Graph API.
  • Connection goes via Facebook Business Manager. You may need to accept Meta's terms once.

TikTok​

Scopes requested: user.info.basic, video.list, research.data.basic.

Data you get:

  • Video views
  • Likes, comments, shares
  • Follower growth
  • Top videos

Reddit​

Plan: HOBBY and above.

Scopes requested: read, history, identity.

Data you get:

  • Your submitted posts and their upvotes
  • Comment counts on your posts
  • Subreddit-level engagement (for subs you mod)

Gotchas:

  • Reddit heavily rate-limits third-party apps. Sync is 30 min at best; if you're posting frequently, metrics may lag.

Google Search Console​

Plan: HOBBY and above.

Scopes requested: webmasters.readonly.

Data you get:

  • Impressions (how often you showed up in Google results)
  • Clicks (CTR)
  • Average position
  • Top queries (15)
  • Top landing pages (15)
  • Country breakdown
  • Device breakdown

Gotchas:

  • GSC has a built-in 2-day data lag. "Today" numbers are always incomplete — wait 48 hours for reliable trend analysis.
  • You need to have verified the site in GSC already. If you haven't, do that first at search.google.com/search-console.

Plan: HOBBY and above.

Scopes requested: adwords (read-only).

Data you get:

  • Impressions
  • Clicks (CTR)
  • Average CPC
  • Spend
  • Top campaigns

Gotchas:

  • Manager (MCC) accounts work — FunnelFizz lets you pick which sub-account to connect.
  • Individual campaign-level data is pulled, not keyword-level.

Stripe​

See Quickstart → Connect Stripe for setup.

Auth: Restricted API key OR the FunnelFizz Stripe App (same key under the hood).

Required permissions (read-only):

  • Customers
  • Charges and Refunds
  • Events
  • Products and Prices
  • Invoices
  • Subscriptions
  • Balance

Data you get:

  • Customer records (created date, email, country, default payment method)
  • Subscriptions (product, price, trial end, current period, status)
  • Charges (gross, net, refunds)
  • Invoices
  • Events (full webhook stream for real-time updates)

How it feeds your funnel:

  • TRIAL stage: counts subscriptions with status = "trialing".
  • CUSTOMER stage: counts subscriptions with status = "active".
  • Churn trichotomy: computed from subscription state transitions.

Sync frequency: 15 min via polling + real-time via webhooks (webhooks are auto-configured via the Stripe App, optional for API-key mode).

Disconnecting or re-authenticating​

Settings → Integrations → [Provider] → Disconnect revokes FunnelFizz's access and clears the stored tokens. Historical aggregated data stays in your funnel; new data stops flowing.

If a provider's token expires (most OAuth tokens rotate every 60–90 days) and auto-refresh fails, you'll see a red "Reconnect" banner on the integration. Click it, re-auth, done.

Manual entries​

For data sources that aren't in the provider list, every stage has a Manual input where you can paste daily impression/visitor/customer numbers. Clunky but available — and useful for backfilling historical data from before you connected a provider.

Requesting a new provider​

Email hello@funnelfizz.com with the platform name and why it matters to your funnel. We prioritize by request volume.

Next: Mentions → — how to monitor 13+ sources for brand mentions.