Integration Errors
This guide covers common errors you might encounter when connecting integrations to Appstack and how to resolve them.
Most integration errors are related to authentication or permissions. Always ensure you have the correct access levels before connecting.
Meta, Google, and TikTok Ads Integration Errors
Meta/Google/TikTok Authentication Failed
What it means: Your Meta/Google/TikTok access token is invalid, expired, or has been revoked.
How to fix:
- Go to your Meta/Google/TikTok Business Manager
- Check that your user account has the correct permissions
- Try to connect again in Appstack
The token generated through OAuth has an expiry date. If this error appears several weeks after you connected, please refresh your credentials.
Application Not Found
How to fix:
- Verify your app ID is correct in Meta/Google/TikTok Business Manager
- Ensure your user account has access to the correct ad account
- Make sure you're running campaigns for this app (the app must have campaign data)
- Check that the app is connected to the right ad account
This often happens when you haven't started running campaigns yet. Try again once you have active campaigns.
App Store Connect Integration Errors
App Store Connection Failed
How to fix:
- Double-check your Key ID, Issuer ID, Private Key, and Vendor ID
- Verify the API key is active and not expired
- Ensure the key has the correct permissions (Admin, Sales and Reports + App Manager)
- Try generating a new API key if the issue persists
Make sure all four credentials (Key ID, Issuer ID, Private Key, and Vendor ID) are correct and match your App Store Connect setup.
Incorrect Private Key Format
How to fix:
- Download a new API key from App Store Connect
- Ensure you copy the entire key including the header and footer lines:
-----BEGIN PRIVATE KEY-----
[your key content]
-----END PRIVATE KEY----- - Make sure there are no extra spaces or characters
Don't forget to include the header and footer lines when copying your private key!
App Store access check failed
How to fix:
- Contact support with the specific error details
- This is an internal system error that requires investigation
App Store Permissions Missing
How to fix:
- Check your user role in App Store Connect
- Ensure you have Admin or Account Holder access
- Verify the API key has the correct access level:
- Admin: Unlocks all metrics
- Sales and Reports + App Manager: Unlocks Trends and Reviews
- Sales and Reports: Unlocks Trends only
- Ask your account administrator to grant the necessary permissions
You need Admin or Account Holder access to generate API keys. If you don't see the API section, ask your account owner for help.
App Store Agreement Required
How to fix:
- Log into App Store Connect
- Accept any pending agreements
- Try connecting the integration again
This is usually resolved by simply accepting the pending agreement in your App Store Connect dashboard.
App Store Reports Not Accessible
How to fix:
- Ensure your API key has the correct access level:
- Admin: Unlocks all metrics and reports
- Sales and Reports + App Manager: Unlocks Trends and Reviews
- Sales and Reports: Unlocks Trends only
- Check that the key has access to all required report types
- Generate a new API key with the appropriate permissions if needed
To unlock all metrics, give Appstack Admin access. For specific features, use the appropriate access level as described in the setup instructions.
Apple Ads Integration Errors
- In Apple Ads, click your account name at the top left.
- In the dropdown, locate the "Campaign Group" section.
- Copy the "Campaign Group ID" — this is your Account ID.
Apple Ads Authentication Failed
How to fix:
- Verify your Client ID, Team ID, Key ID, and Account ID are correct
- Ensure your API key is active and not expired
- Check that your account has the required API role: API Account Manager
- Ensure your Apple Ads account has access to the app used within Appstack
You need API Account Manager access specifically. Having Admin access won't work. The Campaign Management API requires access through a separate Apple Account with API Account Manager access.
No Campaign Data Found
How to fix:
- Verify the app ID is correct in Apple Ads
- Ensure the app has campaign data over the last 30 days
- Check that campaigns are active and running
- Verify your Apple Ads account has access to this app
Your app needs to have active campaigns with data over the last 30 days for the integration to work.
Invalid Key Format
How to fix:
- Double-check your Key ID format
- Ensure you're using the correct key from Apple Ads
- Try using Safari browser if you encounter key format issues
- Ensure you copy the entire key including the header and footer lines:
Make sure there are no extra spaces or characters
-----BEGIN PRIVATE KEY-----
[your key content]
-----END PRIVATE KEY----- - Generate a new API key if needed
When saving API credentials in Apple Ads, you may need to use Safari browser if you encounter any 'invalid key' errors.
Stripe Integration Errors
Stripe Authentication Failed
How to fix:
- Verify your Stripe API keys are correct
- Check that your Stripe account is active
- Ensure you have the required permissions
Play Store Integration Errors
Play Store Authentication Failed
How to fix:
- Verify your Google Play Console credentials
- Check that your service account has the required permissions
- Ensure the Google Play Developer API is enabled
General Troubleshooting Tips
Here's a systematic approach to resolve integration problems:
- Check your permissions: Ensure you have the required access levels for each platform
- Verify app connections: Make sure your app is properly connected to the ad accounts
- Update tokens: Generate fresh API keys and access tokens by reconnecting
- Contact support: If issues persist, reach out to our support team with specific error messages support@appstack.tech
Always ensure you have the correct access levels and permissions before attempting to connect integrations. Most authentication errors occur due to insufficient permissions or expired credentials.