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

Guests

Contact database, CSV import, event invitations

The Guests page is your contact database. Guests are people you can invite to events. They are separate from Community members (buyers who purchased tickets).

Guest List

The table shows all your contacts:

Column Description
Name Full name with avatar (initials)
Email Contact email
Phone Phone number (or "-" if not set)
Company Company name (or "-" if not set)
Events Number of events this guest has been invited to
Actions Edit, invite, and delete buttons

Click any row to view the guest's full profile.

Row Actions

  • Send icon - Opens the invite-to-event modal for this specific guest
  • Edit icon - Opens the edit form with current values
  • Delete icon - Removes the guest (asks for confirmation)

Adding a Guest

Click + Add Guest to open the form.

Field Type Required Default Description
Name Text Yes - Full name of the contact
Email Email Yes - Must be a valid email address. Must be unique across all guests
Phone Text No - Phone number (any format)
Company Text No - Company or organization name
Notes Textarea No - Internal notes (not visible to the guest)
Language Dropdown No English Preferred language for invitation emails. Options: English, French

Validation:

  • Name is required
  • Email must be valid and unique (duplicate emails are rejected with "Email already exists")

Editing a Guest

Click the edit icon on any guest row, or click Edit in the guest detail modal. The same form opens with current values pre-filled.

Guest Detail

Click a guest row to open the detail modal.

Profile Section

  • Large avatar with initials
  • Full name (bold)
  • Email
  • Edit button

Details Grid

Shows all non-empty fields: phone, company, notes, language.

Event History

A table showing every event this guest has been invited to:

Column Description
Event Name Name of the event
Date Event date
Ticket Type Which ticket type was offered
Status RSVP status (Pending, Invited, Accepted, Declined)

If the guest has never been invited, the message "This guest has not been invited to any event yet." is shown.

Importing Guests via CSV

Click the Import CSV button (upload icon) to bulk-import contacts.

CSV Format

The CSV file should have columns matching the guest fields. The first row should be headers:

name,email,phone,company
Alice Smith,alice@example.com,+32123456789,Acme Corp
Bob Johnson,bob@example.com,,

Required columns: name, email. All other columns are optional.

Import Process

  1. Drag and drop your CSV file onto the upload area, or click to select a file
  2. The file is uploaded and processed immediately
  3. On success, you see:
    • "X guest(s) imported successfully"
    • "Y row(s) skipped (duplicates or invalid)" if any rows were skipped
  4. Close the modal to see the updated guest list

Note: Guests with duplicate email addresses are skipped, not overwritten.

Bulk Inviting Guests to an Event

You can invite multiple guests at once from the guest list.

From the Guests Page

  1. Select guests using the checkboxes (or use the header checkbox to select all)
  2. A bar appears showing "X selected"
  3. Click Invite to Event
Field Type Required Description
Event Dropdown Yes Only published events are shown
Ticket Type Dropdown Yes Available ticket types for the selected event. Shows name and price
Quantity Number Yes (default: 1) Number of tickets to offer each guest

After submitting:

  • A success message shows how many guests were invited
  • Guests already invited to the same event are skipped
  • Invited guests appear in the event's Guests tab with "Pending" status

From the Event Detail Page

You can also invite guests from the event's Guests tab using the + Invite to Event button. This works the same way but the event is pre-selected.

Invitation Workflow

The full invitation flow from start to finish:

  1. Add contacts to your guest database (manually or via CSV)
  2. Invite to event by selecting guests and choosing an event + ticket type
  3. Send invitations from the event's Guests tab (select guests, click Send Invitations)
  4. Guests receive an email with a unique RSVP link
  5. Guest clicks the link and sees event details, offered tickets, and a quantity selector
  6. Guest accepts (tickets are generated, guest is auto-authenticated) or declines
  7. You see the updated status in the event's Guests tab

Resending: Click the send icon on any guest row in the event's Guests tab to resend the invitation email. A new token is generated (the old link stops working).