Guide: Using App Store Connect with Databox

    We have identified reliability issues with the App Store Connect integration that results in the Data Source displaying an error (“2FA token has expired’ or “Fatal connect error, please try again (timeout)“. This appears to be a universal issue with the App Store Connect API.

    In order to ensure we provide our users with stable, reliable data, we have decided to temporarily remove the App Store Connect integration from our list of available integrations. Therefore, it is not possible to connect new App Store Connect Data Sources.

    We are working to determine if there is a more stable way to access App Store Connect data and will restore the integration if so. You can upvote the development for this integration here. Please contact Support directly with any questions.


How to connect App Store Connect to Databox


How to connect App Store Connect to Databox

To connect an App Store Connect Account in Databox, go to  Data Manager > + New connection. Type App Store Connect in the search bar and click on the green Connect button. 

This will open the  Authorization window, which is where you will be prompted to enter your App Store Connect login credentials and two-factor authentication (2FA) code to authorize the Databox app. 

Pro Tip: It's recommended you create a separate App Store Connect user to connect your App Store Connect account with Databox.

Pro TipIf you do not have two-factor authentication ( 2FA) enabled for your App Store Connect Account, enter the following 2FA code: ''123456''.

To access your  two-factor authentication (2FA) code, follow the steps below:

 Login to your App Store Connect Account
   When a pop-up window with a geo map appears, click  Allow to confirm your location
  Next, copy the 2FA code that appears in the pop-up window

 Paste the 2FA code to Databox connect pop-up window and click Activate

What App Store Connect permissions do you need to connect to Databox?

The App Store Connect user that is connecting the App Store Connect Account to Databox should have Read Only access to analytics and Sales permissions enabled.

To check user permissions or add a user with the necessary permissions, follow the steps below:

 Login to your App Store Connect Account
 Navigate to Users and Access on the lefthand menu
  Select a User from the list or click  + to add a new User
  In the  Roles section, select the  Sales checkbox

  In the Apps section, do not choose any specific apps. When you connect App Store Connect with Databox, you'll have the ability to choose from any apps that the User has analytics access to.   

  Click  Save to save the settings

How much historical data is synced when you first connect App Store Connect to Databox?

When you connect a new App Store Connect Data Source in Databox, 90 days' worth of historical data is initially synced. 

Certain Metrics may have more or less historical data available. For more information about the amount of historical data available for a specific Metric, please contact our Support Team at

Pro Tip: Once your App Store Connect Data Source is connected and actively syncing data, we store the data that's collected in our own database.This allows us to accumulate more data over time as more data syncs are made so that you can report on more historical App Store Connect data in your Databox reports. Learn more here

What time zone does App Store Connect data sync in? 

App Store Connect data is synced in the time zone set in UTC. 

How often does App Store Connect data sync?

All App Store Connect Data Sources will sync once a day with Databox. Learn more here.

Why is my App Store Connect Data Source disconnected?

App Store Connect connections are established using tokens. Apple sets its tokens to expire after 30 days. This means that every 30 days, your App Store Connect Data Source will be disconnected.

In order to reconnect your App Store Connect Data Source, navigate to Data Manager and click the Reconnect button next to your App Store Connect Data Source. 

How to access pre-built App Store Connect Templates

 Navigate to Databoards > Public Templates
 In the Data Source drop-down list, select App Store Connect
 To view a preview of the Template populated with dummy data, click Preview
 To pull the Template into your Account and re-populate it with your own App Store Connect data, click Use Template
 Select the appropriate App Store Connect Data Source from the drop-down list to complete the process. The Databoard will be re-populated with data from the selected App Store Connect Account and can be found on the  Databoards page
Pro Tip: Once the Databoard is available on the Databoards page, it is completely disconnected from the public Template. Therefore, you can further customize this Databoard to meet your specific needs using the Designer.

Popular App Store Connect Templates

App Store Connect App Store Connect Sales Overview
This App Store Connect Template gives insight into your conversion funnel and high-level app. analytics. 
This App Store Connect dashboard tracks in-app purchase and sales activities. 

How to build a Databoard using App Store Connect data

 Navigate to  Databoards > + New Databoard > Start Blank
 Click on the Metrics  Library icon on the lefthand side of the Designer
 Select the appropriate App Store Connect Account from the Data Source drop-down list in the Metrics  Library
 View the list of pre-built App Store Connect Datablocks in the Metrics Library. Drag and drop your selected Datablock onto your Databoard    

 If a pre-built Datablock isn't available for your use case, click on the  Visualization Types icon under the Metrics Library icon

 View the list of Visualizations available in Databox. Drag and drop your selected Visualization onto your Databoard
 Click on the Datablock on the Databoard to open the corresponding Datablock Settings on the righthand side of the Designer
 Select the appropriate App Store Connect Data Source and Metric in the righthand Datablock Settings. This will update the Datablock and it will populate the Datablock with the corresponding data
 Complete steps 4-8 until your Databoard is complete

Popular App Store Connect Metrics

App Units Product Page Views Sales

Impressions Total Sessions Sessions

View a full list of App Store Connect Metrics available in Databox here.

How to use the Query Builders for App Store Connect

The Query Builder for App Store Connect allows you to create Custom Metrics using a combination of Metrics, Dimensions, and Filters. 

Learn more about the Query Builder for App Store Connect here

Additional Information


Metric Considerations

  • Certain Metrics- like Sessions, Active Devices, and Crashes - can be enabled and disabled by iOS users. Therefore, the Metric Value may be lower than the actual value if your app users have disabled this tracking.
Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.

Still need help? Contact Us Contact Us