Adding New App

This guide describes how to add your app to Apphud

To add a new app, click on "Add new app" at the top:

Or just register and application create screens will show automatically. Fill the information about the app.

App Name

This is a name of the app that will be used in reports.

Then you will have options to configure iOS and Android apps accordingly.

Add iOS App

Bundle ID

To get Bundle ID open App Store Connect, go to "My Apps" and choose your app. At the app page find “Your Bundle ID”.

App Store Shared Secret

How to find App-Specific Shared Secret
Create and copy App-Specific Shared Secret

To get Shared Secret:

  1. Open App Store Connect, go to my "My Apps" and choose your app.

  2. Select "Manage" under the In-App Purchases heading.

  3. Click on the "App-Specific Shared Secret" link on the right.

  4. Create and copy the Shared Secret.

Please make sure that App Store Shared Secret you pasted to Apphud is correct.

Add Android App

Package Name

Enter your app's package name.

Service Account JSON

Please provide contents of your Google Play Service Account JSON as described here.

URL for App Store Server Notifications

Providing App Store Server Notifications URL is important. By using them Apphud will be able to detect cancellations and refunds in real-time.

  1. Copy your URL for App Store Server Notifications from Apphud. It can be found when adding new app in a wizard or in Apphud > Settings > iOS app settings.

  2. Open App Store Connect, go to “My Apps” and choose your app.

  3. Under "App Information" find "URL for App Store Server Notifications", paste generated URL and save changes.

If URL for App Store Server Notifications is missing in App Store Connect, try to create in-app purchases first.

If everything is set up correctly, you should see in Apphud Settings last time when notification is received from Apple. You can read more about App Store Notifications here.

Displays last time when Apple notification is received

App Store Server Notifications Proxy

If you already use App Store Server Notifications and can't paster URL provided by Apphud, you can use App Store Server Notifications Proxy feature. Apphud will automatically send all incoming server-to-server webhooks from Apple to your server.

  1. Go to "App Settings" in Apphud.

  2. Paste your subscription status URL into "Proxy App Store Server Notifications to this URL" field:

Google Play Service Credentials

This is a difficult process but it is required in order for us to validate in-app purchases in Google Play.

Go to Settings page in your Google Play Console and Open API Access tab:

Click on a "Choose a project to link" button:

Agree to Terms:

Next let's create a service account.

Create Service Account

Click on "Create new service account":

Navigate via link to Google Cloud Platform:

Click on "CREATE SERVICE ACCOUNT" button:

Enter the name of your service account and click "CREATE":

Select "Owner" for this account permissions:

Next you will need to create a new private key for this account:

Select "JSON" key type and click "CREATE":

After that you will need to grant financial access to this account.

Grant Permissions to Service Account

Click on "Grant access" button:

Select "Account permissions" and grant the following permissions:

  • View app information and download bulk reports (read-only)

  • View financial data, orders, and cancellation survey responses

  • Manager orders and subscriptions

Click on "Invite User" and "Send Invite".

Grant Permissions to your App

In the Users and Permissions page in App permissions tab select your app and Apply permissions:

Your App permissions should be automatically granted by account permissions. Click on "Apply":

Upload Service Account JSON to Apphud

Upload Service Account JSON file or enter JSON contents to Apphud when creating new app or if you already have created app, then in "Settings > Android app settings" page:

You're done!