Connect the Apple App Store
Create an App Store Connect API key with the right role, add it, and pick your apps.
Apple does not use OAuth for reporting. You create an API key in App Store Connect, download it once, and paste its details into Revenue Sensor.
Before you begin
- Account Holder or Admin access to App Store Connect, so you can create keys.
- Your Vendor Number, from App Store Connect → Payments and Financial Reports.
Create your API key
- 1
Open the Integrations keys page
App Store Connect → Users and Access → Integrations → App Store Connect API.
- 2
Generate a key
Create a new key and give it a name you will recognise, such as “Revenue Sensor”.
- 3
Give it a reporting role
The key needs a role that can read sales and finance reports — Admin, Finance, or Sales. A key with only Developer or App Manager access can list your apps but cannot read revenue, which produces an app list with no money in it.
- 4
Download the .p8 file
Apple lets you download the private key exactly once. Save it somewhere safe before you leave the page.
The single most common failure
If revenue comes back empty while your app list loads fine, the key almost always lacks a Sales or Finance role — or the Vendor Number belongs to a different Apple account than the key. Re-check both before anything else.
Add your credentials
- Issuer ID — shown above the key list in App Store Connect.
- Key ID — shown in the row for the key you created.
- Private key — the contents of the .p8 file you downloaded.
- Vendor Number — from Payments and Financial Reports.
Choose your apps
Revenue Sensor lists every app the key can see. Select the ones you want tracked. Only the selected apps are synced and only they count toward your plan's limits.
What gets imported
Apple's sales and finance reporting: units, proceeds, and the payout figure after Apple's commission. That payout figure is what appears as revenue in the P&L — not the gross price the customer paid.
Reporting lag
Apple's daily sales reports settle a day or two behind, and the finance reports that carry final payouts land monthly. Recent days will move slightly as Apple restates them.