App Upload Fails in Esper Console — Check Subscription Status and APK Validation

Android

Title: APK upload fails in Esper Console — subscription and validation fix

When uploading an internal APK to the Esper Console, the upload fails immediately or mid-transfer, sometimes with no clear error message.

Why this happens

APK uploads are blocked by two distinct causes: an inactive or restricted Esper subscription that prevents new app entries, or an APK that fails Esper's validation checks — such as a missing signature, a duplicate version code, or a file that exceeds the upload size limit. Both failures present at upload time.

Steps to resolve

1. Check your subscription status. Navigate to Settings → Subscription in the Esper Console. Confirm the license shows as active and that the expiry date has not passed. If the subscription has expired, contact your Esper account manager to renew before continuing — uploads are blocked at the platform level until the license is restored.
2. Verify the APK is correctly signed. The APK must be signed with a valid debug or release certificate. An unsigned APK will be rejected during validation. If you are unsure, test the signature locally by running:

   adb install your-app.apk

   A successful local install confirms the APK is correctly signed and installable.
3. Confirm the version code is unique. Navigate to Apps & Configuration → Private Apps and check the version codes already present for the same package name. Esper rejects any APK whose version code duplicates an existing entry in your app library. Increment the version code in your build and repackage if needed.
4. Check the file size. Esper enforces an upload size limit. If your APK is exceptionally large, check the current limit in the Esper documentation. Split APKs or app bundles may need to be restructured before upload.
5. Note the exact error message. If the upload fails, capture the full error text displayed in the Esper Console — including any error code shown as ERROR_CODE format — and take a screenshot. The specific code identifies whether the failure is a subscription, validation, or infrastructure issue.
6. Retry the upload. Navigate to Apps & Configuration → Private Apps, select + Upload APK, choose your validated APK file, and initiate the upload.

Verify: After a successful upload, the app appears immediately under Apps & Configuration → Private Apps with the correct package name and version code displayed. No additional confirmation step is required.

If this doesn't resolve it

Before contacting support, collect the following:

• The exact error message or error code from the Esper Console
• A screenshot of the failed upload screen
• The APK package name, version code, and file size
• A confirmation of your current subscription status from Settings → Subscription

If your subscription shows as active but uploads remain blocked, your account's backend entitlements may be out of sync with the Console display. Contact Esper Support with the information above so the team can verify your account configuration directly.

Still need help?

If app uploads continue to fail after verifying your subscription status and APK file, submit a support ticket and include your subscription plan details, the specific APK filename, and any error messages displayed in the console.