Troubleshooting

License activation fails

Symptoms: “Invalid license” or network error on activate.

Try:

1. Confirm key copied fully from receipt (no extra spaces)
2. Check internet connection
3. Confirm you haven’t exceeded 2 active devices
4. Email support@kingmakeranalytics.com with order ID

Gmail sign-in fails

Symptoms: Browser OAuth loop or “access blocked”.

Try:

1. Confirm you’re using a supported Google account
2. If Gmail sign-in is unavailable for your account, contact support — access may be limited during pre-release rollout
3. Revoke old Inbox Maid access at Google Account Permissions and retry
4. See Security page for required scopes

OpenAI errors

Symptoms: Model errors, rate limits, or “OpenAI not ready”.

Try:

1. Verify API key in Settings → Connected Accounts
2. Confirm billing active at OpenAI
3. Reduce batch size on Run Cleanup
4. Check Model Health panel for diagnostics

Windows SmartScreen blocks installer

Symptoms: “Windows protected your PC” on unsigned installer.

Try:

1. Click More info → Run anyway (only if downloaded from inboxmaid.com)
2. Wait for signed release — check Download page

Credential storage unavailable

Symptoms: Runs blocked; keyring error.

Try:

1. Settings → Revalidate Credential Storage
2. Confirm Windows Credential Manager is available
3. Restart app

Run completes with warnings (degraded)

Try:

1. Reduce Emails to process now
2. Check Gmail connectivity
3. Review Model Health
4. Re-run preview before live apply

Export diagnostic bundle

Settings → Privacy & Data → Export diagnostic bundle — attach to support email. Bundle excludes secrets, license data, and email bodies.

Still stuck?

Contact support with app version, Windows version, steps to reproduce, and screenshot or error text. Target response: 1 business day (Mon–Fri PT).