Connect App Store Connect to ShipVitals
Certificate and profile expiry, daily downloads and monthly proceeds per app
AvailableKey file · about 4 minutes
What it reads
- Developer role
- Reads certificates and profiles; ShipVitals never creates one
- Sales role
- Reads the daily Sales and Trends summary
- Finance role
- Only for monthly proceeds: reads Apple's financial reports
Not read-only at App Store Connect. App Store Connect has no read-only role: Developer can also create certificates. ShipVitals only reads certificates, profiles, apps, and sales and finance reports.
What ShipVitals keeps: The API key (.p8), its id, the issuer id and the vendor number, encrypted.
How to connect
- Open Users and Access → Integrations → App Store Connect API.
- Generate a key named ShipVitals with the access listed below (Finance only for proceeds). Don't choose Admin.
- Download the .p8 file and drop it below.
- Copy the Issuer ID shown above the keys, and your vendor number from Payments and Financial Reports.
About 4 minutes.
How to revoke
Removing the connection in ShipVitals deletes the stored key at once.
What it powers
Dashboard tabs: Revenue, Usage, Obligations.
Figures it fills
- App Store installs
Sync
- Free: Daily
- Indie: Hourly
- Studio: Every 15 minutes
- Agency: Every 15 minutes
Troubleshooting
Each error a connection can hit, and its fix. The connection's health page names the one it hit.
- Access refused
- App Store Connect no longer accepts what ShipVitals signs in with. Create a new key, or connect again, and replace it in the connection.
- A permission is missing
- What ShipVitals has can't read everything it needs. Add the permissions under What it reads, or create a new key with them, and test again.
- Access removed
- ShipVitals' access was removed in App Store Connect. Connect it again; the history it brought in is kept.
- Rate-limited
- App Store Connect asked ShipVitals to slow down. Nothing to do: the sync carries on by itself and catches up.
- Quota reached
- The account used up a App Store Connect quota. The sync resumes when the quota resets.
- Not found
- Something the connection reads is gone from App Store Connect: renamed, moved or removed. Review the connection's resources, or connect again.
- App Store Connect is unavailable
- App Store Connect is having trouble on its side. Check its status page; ShipVitals retries by itself.
- Couldn't reach App Store Connect
- The request didn't get through. ShipVitals retries by itself; if it keeps failing, check that App Store Connect is reachable.
- An answer ShipVitals didn't expect
- App Store Connect answered in a shape ShipVitals didn't expect, usually after a change on its side. We're told, and the data you have is kept.
- A setting doesn't work
- A field in the connection doesn't work with App Store Connect. Check it against How to connect, and test again.