Admin Common Errors

At a glance

• This page runbook when organizer-facing functionality is broken in production.
• It prioritizes fast diagnosis and deterministic recovery actions.

Do this

1. Identify impact area:

• access/auth
• payments
• media/documents
• data exports or admin actions

2. Confirm exact failing route and error message.
3. Validate config and secrets before code-level debugging.
4. Apply targeted fix and rerun affected workflow.

When it fails

• 403 on admin routes: add user email to app.adminEmails, then sign in again.
• OTP failures: verify Mailgun credentials and sender domain health.
• Stripe mismatches: verify webhook endpoint and signing secret pair.
• Media upload failures: verify R2 binding and file constraints.
• Export/refund failures: verify admin session and Stripe object state.
• See Troubleshooting.