App upload fails in Esper Console with suspected expired/inactive subscription

Android

If you're unable to upload an internal APK to the Esper Console, the issue may be related to your subscription status or APK validation. This article walks you through troubleshooting steps to resolve app upload failures.

Before you begin

Gather the following information:

The exact error message displayed in the Esper Console
A screenshot of the error
The APK file you attempted to upload

Step 1: Check your subscription status

Verify that your Esper Enterprise subscription is active and not expired.

In the Esper Console, navigate to Settings → Subscription.
Confirm your license is active and check the expiry date.
Verify there are no entitlement restrictions on your account.

If your subscription has expired, contact your account manager to renew your license before proceeding with app uploads.

Step 2: Validate your APK file

Ensure your APK is properly formatted and meets Esper's requirements.

Verify the APK is properly signed with a valid certificate (debug or release).
Confirm the version code is unique and not already in your app library.
Test the APK locally using the Android Debug Bridge (adb):
```
adb install .apk
```
Confirm the file size is within Esper's supported upload limits (consult our Help Center for current limits).

Step 3: Attempt the upload again

Once you've verified your subscription and validated your APK, retry the upload.

Navigate to Apps → Private Apps → + Upload APK.
Select your APK file and initiate the upload.
If the upload fails, capture the exact error message and take a screenshot.

Step 4: Confirm successful upload

After a successful upload, verify the app appears in your app library with the correct details.

Navigate to Apps → Private Apps.
Locate your newly uploaded app.
Confirm the version code and package name match your APK.

If the upload still fails

If you've completed the steps above and uploads are still blocked:

Search your error message in our Help Center — many APK upload errors have specific error codes and documented solutions.
If your subscription status appears active in the Esper Console but uploads remain blocked, your backend entitlements may need adjustment. Contact Esper Support to verify your account settings.
If your APK has unusual manifest configurations or is exceptionally large, provide the APK file and error message to our support team for advanced troubleshooting.

Still need help?

If you've completed these steps and your issue persists submit a support ticket. Include the following in your request:

The exact error message from the Esper Console
A screenshot of the error
Your APK file (if possible)
Confirmation of your current subscription status