SpeckyDocs

Stripe Integration

What it does

Connect revenue, subscriptions, and customers.

How your data reaches Specky

Specky pulls from Stripe on a schedule. A sync runs when you open your workspace if the data has gone stale, and you can trigger one by hand from the integration card at any time.

What you'll need

  • Secret Key (Required) — Stripe → Developers → API keys → Restricted key with Customers/Subscriptions/Charges read access.

    • Setup

    Go to Settings → Integrations, find Stripe, and click Connect.

    Create a restricted key (recommended)

  • Go to Developers → API keys → Create restricted key
  • Enable Read access on: Customers, Subscriptions, Charges
  • Copy the key above

    • Use a restricted key, not your full secret key, to follow least-privilege principles.

    Data synced

  • Active subscriptions and estimated MRR
  • Customer list with status
  • Recent charges and revenue
  • Churn signals (cancel_at_period_end)

    • After connecting

    Everything Specky pulls in from Stripe shows up in Discovery alongside your other sources, and feeds synthesis, clustering, and the AI chat's answers about your product. You don't have to do anything with it directly — it's there so the rest of Specky has something to reason over.

    Disconnecting Stripe removes both the connection and the signals it brought in.

    Troubleshooting

  • Connected, but nothing appears. Open the Stripe card and run a sync by hand. If it errors, the card shows the reason.
  • "Upgrade to connect". Your plan caps how many integrations you can connect at once, and a few providers are Scale-only. Settings → Usage shows where you stand.
  • Credentials stopped working. Tokens expire and get revoked. Reconnect with a fresh one — your existing signals are kept.

    • See the Stripe integration page for what it's for and the questions people usually ask first, or the Integrations Overview for how integrations work in general.