Skip to content

All integrations

Connect App Store Connect to ShipVitals

Certificate and profile expiry, daily downloads and monthly proceeds per app

AvailableKey file · about 4 minutes

Connect App Store Connect

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.

Every connector's scopes, on one page

How to connect

  1. Open Users and Access → Integrations → App Store Connect API.
  2. Generate a key named ShipVitals with the access listed below (Finance only for proceeds). Don't choose Admin.
  3. Download the .p8 file and drop it below.
  4. 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.

Docs