Skip to main content

​
What FloKit reads from App Store Connect

Once connected, FloKit ingests the following App Store Connect data:
  • Subscription sales reports: units, proceeds, and revenue by product and country
  • Subscription status reports: active subscribers, trial subscribers, grace period, and churn by cohort
  • Refund rates by product and territory
  • Proceeds vs. gross revenue breakdown (after Apple’s platform fee)
  • Introductory offer and promotional offer redemption counts
App Store Connect does not provide user-level attribution. Install-to-subscription joins require a connected MMP (AppsFlyer or Adjust).

​
Required access

App Store Connect API key with the Finance role (or Sales and Trends at minimum). Generate in App Store Connect → Users and Access → Integrations → App Store Connect API. The Finance role provides access to financial reports and proceeds data. Sales and Trends provides subscription and sales reports but may not include all financial fields. Use Finance if available. You will need:
  • .p8 private key file (downloaded once at key creation — not retrievable after)
  • Issuer ID (visible on the App Store Connect API page)
  • Key ID (shown alongside the key entry in the API key list)
  • App ID (numeric identifier from App Information in App Store Connect)

​
A note on data lag

App Store Connect financial and sales data is typically delayed 1–2 business days. Subscription status reports (active/trial/churned counts) update daily but also carry a 1–2 day lag. FloKit reflects the most recent available data and timestamps all App Store Connect data with its report date. Do not expect same-day revenue data from App Store Connect. For real-time subscription event delivery, use RevenueCat or Adapty alongside this integration.

​
Setup

1

Generate an App Store Connect API key

In App Store Connect → Users and Access → Integrations → App Store Connect API, click the + button to generate a new key. Set the role to Finance. Note your Issuer ID at the top of the page and the Key ID shown next to the new key entry.
2

Download the .p8 private key file

Immediately after generating the key, click Download API Key to save the .p8 file. Apple only allows you to download this file once. If you lose it, you must revoke the key and generate a new one.
3

Find your App ID

In App Store Connect → My Apps → [Your App] → App Information, scroll to the General Information section and copy the Apple ID (a numeric value, e.g. 1234567890). This is different from your bundle ID.
4

Add App Store Connect in FloKit

In FloKit → Settings → Integrations → App Stores, select App Store Connect. Upload the .p8 file and enter:
  • Issuer ID
  • Key ID
  • App ID (numeric)
5

Wait for report backfill

FloKit immediately begins pulling available sales and subscription reports. Depending on how long your app has been on the App Store, backfill may cover 12–24 months of report history. Progress is visible in FloKit → Data → Sources → App Store Connect.

​
Validation checklist

  • .p8 key file, Issuer ID, Key ID, and App ID entered in FloKit
  • Sales reports visible in FloKit → Data → Sources → App Store Connect
  • Proceeds data appearing in FloKit → Reports → Revenue → iOS
  • Subscription status report showing expected active subscriber counts
  • Report date lag of 1–2 days visible on report timestamps

​
Common issues

“Invalid credentials” error after uploading .p8 file The most common cause is an Issuer ID or Key ID mismatch. Copy both values directly from the App Store Connect → Users and Access → Integrations → App Store Connect API page. Note that the Issuer ID is shown at the top of the page, not per-key. No subscription status report data Subscription status reports are a separate report type from sales reports. Confirm your API key has Finance role access. Some App Store Connect accounts require a finance agreement to be accepted before financial reports become available. Revenue lower than expected App Store Connect reports proceeds — revenue after Apple’s platform fee (15% or 30% depending on your program). Gross revenue is proceeds divided by (1 − fee rate). FloKit shows both gross and net figures. Verify which figure you are comparing against in FloKit → Reports → Revenue → iOS → Revenue type. Reports not updating App Store Connect reports are generated once daily. If a report has not updated in more than 48 hours, check Apple’s system status at developer.apple.com/system-status — Apple occasionally delays report generation during high-volume periods.

​
What this unlocks in FloKit

  • iOS revenue reconciliation against finance-approved App Store figures
  • Proceeds vs. gross revenue breakdown by product and country
  • Country-level subscription performance and proceeds comparison
  • Subscription status cohort curves (active, trial, churned) from Apple’s reports
  • Refund rate tracking at the product and territory level