what's the app

Adapty Setup

Last updated: January 24, 2026

Follow these steps to connect your app with Adapty. This guide will walk you through finding your App ID and Secret API Key.

💡 Quick setup! Adapty integration is straightforward - you just need your App ID and Secret API Key from your Adapty Dashboard.

🔒

Read-only access

We use your Adapty API key to retrieve analytics data and revenue metrics. We will never modify, update, or delete anything in your Adapty account.

Before You Start

Make sure you have:

  • Access to your Adapty Dashboard account
  • Admin or Owner role in Adapty (to access API keys)
  • An active Adapty project with at least one app configured
1

Find Your Adapty App ID

Your App ID (also called Public App Key) is used to identify your app in Adapty. It's safe to share publicly and is required for API access.

📍 Adapty Dashboard → Settings → API Keys

  1. 1.Go to Adapty Dashboard
  2. 2.Click on Settings in the left sidebar
  3. 3.Click on API Keys in the Settings menu
  4. 4.Find the Public App Key section. Your App ID will be displayed here (it starts with public_live_ or public_sandbox_)
  5. 5.Copy the entire App ID - you'll need it in Step 3
💡

What's the difference?

Public App Key (App ID) is safe to share and is used for client-side SDK integration. Secret API Key (used in Step 2) is private and should never be exposed publicly.

2

Get Your Secret API Key

Your Secret API Key is used for server-side API access. Keep this key secure and never share it publicly.

📍 Adapty Dashboard → Settings → API Keys

  1. 1.You should already be on the API Keys page from Step 1
  2. 2.Find the Secret API Key section. Your key will be displayed here (it starts with secret_live_ or secret_sandbox_)
  3. 3.Click the "Copy" button or manually select and copy the entire Secret API Key
  4. 4.Store it securely - you'll need it in Step 3
⚠️

Keep it secret!

Your Secret API Key should never be committed to version control, shared in public forums, or exposed in client-side code. If you accidentally expose it, regenerate it immediately in Adapty Dashboard.

3

Enter Your Credentials

Now you'll enter your App ID and Secret API Key into our app connection form.

  1. 1.Go to your app connection page in our system (click "Add App" button)
  2. 2.Click on the "Adapty" tab
  3. 3.In the "1. Adapty App ID" field, paste the Public App Key you copied in Step 1
  4. 4.In the "2. Adapty Secret API Key" field, paste the Secret API Key you copied in Step 2
  5. 5.(Optional) Enter your X handle if you want to link your profile
  6. 6.Click "Add your app" to complete the setup

That's it!

After clicking "Add your app", we'll validate your credentials and start fetching your analytics data. Your app should appear on the leaderboard within a few minutes.

Important Notes

What we access

We only access your analytics data and revenue metrics from Adapty. We cannot modify your app, change settings, or access any other data beyond what's needed to display your revenue metrics.

🔐

Security

Your Secret API Key is encrypted and stored securely using AES-256-GCM encryption. Never share this key publicly or commit it to version control. If you accidentally expose it, regenerate it in Adapty Dashboard immediately.

📊

Data sync

We fetch your analytics data from Adapty's Export Analytics API. Data is updated regularly to ensure your metrics are always current. The first sync may take a few minutes to complete.

Troubleshooting

"Invalid credentials" or "Authentication failed"

  • Make sure you copied the entire App ID and Secret API Key without any extra spaces
  • Verify the App ID starts with public_live_ or public_sandbox_
  • Verify the Secret API Key starts with secret_live_ or secret_sandbox_
  • Make sure you're using the correct keys for your environment (live vs sandbox)

"Cannot find analytics data"

  • Make sure your Adapty project has at least one app configured
  • Your app needs to have some analytics data (subscriptions, transactions, etc.) for metrics to appear
  • Wait a few minutes for the initial data sync to complete

"Permission denied"

  • Make sure you have Admin or Owner role in Adapty to access API keys
  • Verify the Secret API Key hasn't been revoked or regenerated

Still having trouble?

Make sure you've completed all 3 steps above. If you're still experiencing issues, double-check that both the App ID and Secret API Key match exactly what's shown in Adapty Dashboard.

Privacy Policy|Terms of Service