Fictura
Apps & keys

Create an app

An app is the unit everything else is scoped to: keys, events, paywalls, connections, and team access.

Dashboard → New app. Three fields, one of which matters more than it looks:

  • Name — what the dashboard calls it.
  • Category — optional; drives the benchmarks you're compared against.
  • Store commission & tax — the form defaults to Apple's small-business tier (15%); apps created through the API without the field default to the 30% headline rate. Every ROAS figure on the dashboard is net of these, so they're worth setting honestly.

Creation hands you the two credentials the app will use, and both stay retrievable on Dashboard → Setup — they are not shown-once secrets:

  • SDK app key (gk_…) — passed to Growth.init and sent as x-api-key on every SDK and ingest call.
  • RevenueCat webhook URL — paste it into RevenueCat and store billing events start flowing; that feed is the billing spine for entitlements, cohorts, and revenue. See RevenueCat webhooks.

Team access is by membership: teammates see an app when their email is on it, and the dashboard's current app follows you as a cookie. There is no separate staging concept — billing events carry an environment (PRODUCTION or SANDBOX), and a user's entitlement verdict follows their most recent granting event's environment, so always check environment before trusting a verdict in production.