Documentation / Guides / Errors
Protocol specificationAPI referenceGuides
Documentation / Guides / Errors
GUIDE · V1

Errors

Error messages and troubleshooting

This page lists all error messages you may encounter in the admin panel, what they mean, and how to resolve them.

Authentication Errors

Error Meaning Resolution
Invalid email or password The login credentials are incorrect Check your email and password. Passwords are case-sensitive. If forgotten, ask an Owner to reset it
Unauthorized Your session has expired or is invalid Log out and log back in
Forbidden Your role does not have permission for this action Contact an Owner to upgrade your role, or ask them to perform the action

Event Errors

Error Meaning Resolution
Required field (Name) The event name is empty Enter a name for the event
Required field (Slug) The URL slug is empty Enter a slug or let it auto-generate from the name
Slug must be lowercase alphanumeric with hyphens The slug contains invalid characters Use only lowercase letters, numbers, and hyphens (e.g., "summer-gala-2025")
Required field (Date) The start date is not set Select a start date and time
Event not found The event ID in the URL doesn't match any event The event may have been deleted. Go back to the events list

Ticket Type Errors

Error Meaning Resolution
Required field (Name) Ticket type name is empty Enter a name (e.g., "General Admission")
Price must be greater than 0 A non-free ticket type has a price of 0 Either set a price or check "Free Ticket"
Ticket type not found The ticket type was deleted or doesn't exist Refresh the page
Sold out All available tickets have been purchased Increase the available quantity if you want to sell more

Order Errors

Error Meaning Resolution
Order not found The order ID doesn't match any order The order may not exist. Check the orders list
Missing tickets Ticket generation failed after payment Click Retry Tickets to regenerate. This is safe to retry multiple times

Guest and Invitation Errors

Error Meaning Resolution
Required field (Name/Email) A required field in the guest form is empty Fill in the required fields
Invalid email The email format is incorrect Enter a valid email address (e.g., "name@example.com")
Email already exists A guest with this email is already in your database Edit the existing guest instead of creating a duplicate
Guest already invited This guest has already been invited to the same event Check the event's Guests tab for their current status
Upload failed (CSV) The CSV file could not be processed Check the file format: must be a valid CSV with at least name and email columns

Promo Code Errors

Error Meaning Resolution
Code is required The code field is empty Enter a code
Percentage must be between 1 and 100 The discount percentage is out of range Enter a value between 1 and 100
Currency is required for fixed discounts A fixed-amount code needs a currency Select EUR, USD, or GBP
Event is required when ticket type is set You selected a ticket type without selecting an event Select an event first, then choose the ticket type
Reduction code not found The code doesn't exist Check the spelling or create a new code
Reduction code unavailable The code has reached its max uses Increase the max uses or create a new code
Reduction code expired The code's valid_until date has passed Create a new code or extend the validity
Reduction code not applicable The code doesn't apply to the items in the cart Check the code's event and ticket type scope

Venue Errors

Error Meaning Resolution
Required field (Name) The venue name is empty Enter a venue name
Cannot delete venue The venue is linked to one or more events Remove the venue from all events first, then delete

Template Errors

Error Meaning Resolution
Required field (Name) The template name is empty Enter a template name
An unexpected error occurred Template save/delete failed Check file sizes (logo and image uploads have size limits). Try again

Team Errors

Error Meaning Resolution
Required field (Name/Email/Password) A required field is empty Fill in all required fields
Invalid email The email format is incorrect Enter a valid email address
Password must be at least 8 characters The password is too short Use a longer password
Email already exists An admin with this email already exists Use a different email address

General Errors

Error Meaning Resolution
An unexpected error occurred A server-side error happened Try again. If the error persists, check the Worker logs
Rate limited Too many requests in a short period Wait a moment and try again
Not found The requested resource doesn't exist It may have been deleted. Navigate back and refresh

Stripe / Payment Errors

Error Meaning Resolution
Payment failed The Stripe payment could not be processed This is shown to buyers, not admins. Check the Stripe dashboard for details
Stripe error A Stripe API error occurred Check the Stripe dashboard for error details and ensure your API keys are correct

Tips

  • Refreshing the page often resolves stale data issues
  • Check the browser console (F12 > Console) for detailed error information
  • Worker logs can be viewed with: npx wrangler tail events-<slug>
  • API errors follow the format { error: { code, message, details } }. The code is a stable identifier; the message is localized to the user's language
  • Confirmation dialogs appear before destructive actions (delete, invalidate, cancel). They cannot be undone