Partner connection
Import revenue, subscriptions and installs from your Shopify Partner account.
The Partner connection is the source of all revenue, subscription and install data.
Create the token
- Open your Shopify Partner Dashboard and go to Settings → Partner API clients.
- Create an API client with the permissions Manage apps and View financials.
- Copy the access token. Your Partner organization ID is the number in the Partner Dashboard URL.
Connect
In Apps Patrol, open Settings → Partner connection, enter the organization ID and the token, and choose Save & backfill. Only owners and admins can do this. The token is encrypted at rest and is never shown again.
What is imported
- Relationship events: installs, uninstalls, deactivations and reactivations, with the uninstall reason.
- Subscription events: created, updated, frozen, unfrozen, cancelled, including price, billing period and trial days.
- Charges and earnings: recurring and usage charges and the payouts Shopify reports, with Shopify's fee.
The first import walks back through your history in 30-day windows until it finds two empty windows in a row, up to three years. Events are then replayed in the order they happened to work out each shop's current state.
Keeping it current
Sync now fetches events since the last sync. In production this also runs automatically every ten minutes, and daily metrics are recalculated every hour.
Apps created by hand
If you added an app by hand before connecting, the sync adopts it when the names match, instead of creating a second one.
If the sync fails
The status and the last error are shown on the Partner connection tab. The usual causes are a revoked token or missing permissions. Save a new token to retry.