Copy as markdown[View .md](https://docs.funnelfizz.com/concepts/providers "View the raw markdown for this page")[Open in Claude](https://claude.ai/new?q=Read%20https%3A%2F%2Fdocs.funnelfizz.com%2Fconcepts%2Fproviders.md%20and%20help%20me%20with%20this%20FunnelFizz%20topic%3A%20Providers "Open this page in Claude with context")[Open in ChatGPT](https://chat.openai.com/?q=Read%20https%3A%2F%2Fdocs.funnelfizz.com%2Fconcepts%2Fproviders.md%20and%20help%20me%20with%20this%20FunnelFizz%20topic%3A%20Providers "Open this page in ChatGPT with context")

# Providers

Providers are the external accounts FunnelFizz reads data from. All OAuth providers are **read-only**, FunnelFizz never posts, advertises, or modifies data on your behalf.

For the install walkthrough, see [Getting Started → Connect providers](https://docs.funnelfizz.com/getting-started/connect-providers.md).

## Roster[​](#roster "Direct link to Roster")

| Provider                                        | Auth               | Plan  | Stages          | Refresh           |
| ----------------------------------------------- | ------------------ | ----- | --------------- | ----------------- |
| [X (Twitter)](#x)                               | OAuth 2.0          | FREE  | AWARENESS       | 30 min            |
| [YouTube](#youtube)                             | OAuth 2.0          | FREE  | AWARENESS       | 30 min            |
| [LinkedIn](#linkedin)                           | OAuth 2.0          | FREE  | AWARENESS       | 30 min            |
| [Instagram](#instagram)                         | OAuth 2.0          | FREE  | AWARENESS       | 30 min            |
| [TikTok](#tiktok)                               | OAuth 2.0          | FREE  | AWARENESS       | 30 min            |
| [Reddit](#reddit)                               | OAuth 2.0          | HOBBY | AWARENESS       | 30 min            |
| [Google Search Console](#google-search-console) | OAuth 2.0          | HOBBY | AWARENESS       | 60 min            |
| [Google Ads](#google-ads)                       | OAuth 2.0          | HOBBY | AWARENESS       | 60 min            |
| [Stripe](#stripe)                               | Restricted API key | FREE  | TRIAL, CUSTOMER | 15 min + webhooks |

## Workspace-wide, reusable across funnels[​](#workspace-wide-reusable-across-funnels "Direct link to Workspace-wide, reusable across funnels")

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

## Connecting[​](#connecting "Direct link to Connecting")

Stage card → **Connect provider** → pick from the list → OAuth (or paste a Stripe restricted key). Tokens are AES-256 encrypted at rest and scoped to your workspace. If a token expires (most rotate every 60–90 days) and auto-refresh fails, a **Reconnect** banner appears on the integration.

***

## X[​](#x "Direct link to X")

**Scopes:** `tweet.read`, `users.read`, `offline.access`.

**Data:** post impressions (28 days), likes/reposts/replies/quotes, follower count, top 10 posts.

**Notes:** X's free API tier rate-limits hard. Premium accounts get more granular post-level metrics via v2.

## YouTube[​](#youtube "Direct link to YouTube")

**Scopes:** `youtube.readonly`, `yt-analytics.readonly`.

**Data:** video views (28-day rolling), subscribers, watch time hours, top videos.

## LinkedIn[​](#linkedin "Direct link to LinkedIn")

**Scopes:** `r_organization_social`, `r_liteprofile` (read-only, `w_*` is LinkedIn's naming quirk; we don't post).

**Data:** post impressions, reactions/comments/shares, follower growth, top posts.

**Notes:** Personal vs company page is a choice during OAuth, connect each separately to track both.

## Instagram[​](#instagram "Direct link to Instagram")

**Scopes:** `instagram_basic`, `instagram_manage_insights`, `pages_show_list`, `pages_read_engagement`.

**Data:** post reach + impressions, engagement, follower count, top posts.

**Notes:** Business or Creator accounts only. Personal accounts don't expose the Graph API. Connection routes through Facebook Business Manager, accept Meta's terms once.

## TikTok[​](#tiktok "Direct link to TikTok")

**Scopes:** `user.info.basic`, `video.list`, `video.insights`.

**Data:** video views, likes/comments/shares, follower growth, top videos.

## Reddit[​](#reddit "Direct link to Reddit")

**Plan:** HOBBY+. **Scopes:** `read`, `history`, `identity`.

**Data:** your submitted posts and upvotes, comment counts, subreddit-level engagement (mod subs).

**Notes:** Reddit rate-limits hard. 30-min sync is the practical floor.

## Google Search Console[​](#google-search-console "Direct link to Google Search Console")

**Plan:** HOBBY+. **Scopes:** `webmasters.readonly`.

**Data:** impressions, clicks, CTR, average position, top 15 queries, top 15 landing pages, country + device breakdowns.

**Notes:** GSC has a built-in 2-day data lag. Today's numbers are always incomplete, wait 48h for trend analysis. The site must be verified in GSC already; if not, do that first at [search.google.com/search-console](https://search.google.com/search-console).

## Google Ads[​](#google-ads "Direct link to Google Ads")

**Plan:** HOBBY+. **Scopes:** `adwords` (read-only).

**Data:** impressions, clicks, CTR, average CPC, spend, top campaigns.

**Notes:** Manager (MCC) accounts work, pick the sub-account during OAuth. Campaign-level only, not keyword-level.

## Stripe[​](#stripe "Direct link to Stripe")

**Auth:** Restricted API key (`rk_live_…` / `rk_test_…`) or the FunnelFizz Stripe App.

**Required read-only permissions:** Customers · Charges & Refunds · Events · Products & Prices · Invoices · Subscriptions · Balance.

**Data:** customer records, subscriptions (product/price/trial-end/status), charges, invoices, the full webhook event stream.

**One Stripe connection per workspace, one logical link per funnel.** Once you connect Stripe to the workspace and link it to a funnel (one click in the dashboard, or `link_stripe_to_funnel` over MCP), Stripe data flows through every relevant stage, TRIAL trial-detection, CUSTOMER paid-detection, the churn trichotomy, splits by `stripe_product`, automatically. No need to attach Stripe to multiple stages.

**Sync:** 15 min polling + real-time webhooks (auto-wired by the Stripe App; optional in API-key mode).

***

## Manual entries[​](#manual-entries "Direct link to Manual entries")

For sources not in the roster, every stage has a **Manual** input, paste daily impression / visitor / customer numbers. Useful for backfilling from before you connected a provider.

## Disconnecting[​](#disconnecting "Direct link to Disconnecting")

**Settings → Integrations → \[Provider] → Disconnect.** Revokes access, clears stored tokens. Historical aggregates stay; new data stops flowing.

## Requesting a new provider[​](#requesting-a-new-provider "Direct link to Requesting a new provider")

**<hello@funnelfizz.com>**. We prioritize by request volume.