01. Events Overview
Overview of events, the central entity in the platform for managing ticket sales, access control, and attendee experiences.
Overview
Events can either be standalone or form part of a schedule. Both types of events can be manually copied to create a replica standalone event.
Event pages can be customised via event page customisations.
An event has a single start and end date, however, entrance times can be divided into timeslots within the bounds of the event's overall start and end date.
All dates associated with an event-including the start/end dates, the start/end times of any timeslots, the on sale dates, as well as any dates associated with related records (such as zones and sale items)-are set in the event's timezone.
Seating plans may optionally be attached to an event, promoting it to a seated event.
Event Types
When creating an event, you must specify its location type:
Type | Description |
|---|---|
In Venue | A physical event at a specific venue. Customers attend in person. |
Online | A virtual event with no physical location. Supports live streaming via providers like Vimeo or YouTube. |
Both | A hybrid event that is both in-person and streamed online. Requires both a venue and streaming configuration. |
Online and hybrid events can display an embedded live stream on the event
page, with optional chat functionality for supported providers.
Event Status
Events progress through different statuses during their lifecycle:
Status | Description |
|---|---|
Draft | The event is not yet published. It cannot be purchased and is not visible on the shop. |
Published | The event is live and visible to customers (unless hidden). |
Off Sale | The event is published but not currently available for purchase. |
Sold Out | The event has reached capacity or all items are unavailable. |
Cancelled | The event has been cancelled. This action is irreversible. |
Cancelling an event is irreversible. Once cancelled, the event cannot be put
back on sale. Cancellation takes the event off sale, hides it from listings,
and updates its status. Customers are not automatically refunded or
notified-this must be managed separately via the event dashboard.
Approval Workflow
If event approvals are enabled for your company, events may require approval before they can be published. See event approvals for details.
Creating Events
Events are created through a multi-step wizard:
Event Information - Name, description, visibility groups, and event images
Location & Dates - Event type (in-venue/online/both), venue selection, and date/time configuration
Event Codes - Custom data capture fields (if configured)
Mandatory Tags - Required event tags (if configured)
If mandatory organiser details are enabled for your company, you must provide
organiser name, email, and phone during event creation.
Events can also be created and updated via the API. Use the Retrieve Events endpoint to list events, or Retrieve Event for a single event's details.
Configuration
Basic Information
Field | Description |
|---|---|
Event name | The title of the event, displayed throughout the platform including event listings, search results, and the events API. Supports multiple languages. |
Description | A description of the event (WYSIWYG), displayed on the event page via the default event description block. |
Start date & time | When the event begins. |
End date & time | When the event ends. |
Timezone | The timezone for all event dates. See timezones. |
Capacity Controls
Capacity is managed at multiple levels - event, timeslot, sale item group, sale item, inventory, and seating plan. See capacity controls for how these layers interact.
Field | Description |
|---|---|
Maximum tickets per customer | Limits how many tickets a single customer can purchase. Customers must share or transfer tickets beyond this limit. Lower limits can be set on individual tickets. |
Show number of items remaining | Displays a badge on each sale item showing "X Remaining" for items with limited availability. |
Field | Description |
|---|---|
Hidden status | When hidden, the event is not shown in event listing blocks or search results, but can still be accessed via direct link. |
On sale / Off sale status | Controls whether items can be purchased. |
Tags | Event tags used for filtering in search and automatically including events in listings. |
Visibility groups | Controls which admin users can see and interact with the event. |
Field | Description |
|---|---|
Meta Pixel ID | Facebook/Meta conversion tracking. |
Spotify Pixel ID | Spotify ad conversion tracking. |
TikTok Pixel ID | TikTok conversion tracking. |
X Pixel ID | X (Twitter) conversion tracking. |
Google Tag Manager ID | GTM container ID. Note: If GTM is configured at the site level, it cannot be overridden per event. |
Field | Description |
|---|---|
Sales banner | A banner displayed above sale items on the event page. Options: Inherit (use company default), Override (custom for this event), or Hide. When overriding, choose a colour (Company branding, Blue, Green, Yellow, Red) and enter text via WYSIWYG. |
Comment | Internal notes (not visible to customers). |
External ID | Optional identifier for third-party integrations. Exposed in the events API. |
Send purchase summary email | Send an email to specified recipients for every purchase made for this event. Useful for staff to receive real-time sales notifications. |
Refund protection | Configure refund protection for this event. |
Additional Event Settings
The following settings are configured on the event dashboard and documented on their respective pages:
Images, SEO & organiser details - See event page customisations.
Sharing & ticket naming - See item transfers.
Resale - See primary resale. Settings can be inherited from company defaults or overridden per event.
Manual payments - See invoice payments. Event-level settings only apply when all items in an order are for this event.
Access control & scanning mode - See access control.
Live streaming - See online events. Applies to online and hybrid events only.
Relationships
Events connect to many other entities in the platform:
Relationship | Description |
|---|---|
Sale items | Tickets, season tickets, products, event fees, resale fees, guest lists, donations, and bundles attached to the event. |
Timeslots | Time windows within the event for managing entry times and capacity. |
Zones | Access control areas for scanning and entry management. |
Seating plan | Optional venue seating configuration for seated events. |
Venue | The physical location where the event takes place. |
Data capture | Custom questions assigned to collect information from customers. |
Sale periods | Scheduled on-sale and off-sale windows. |
Event media | Ticket designs, Apple Wallet passes, and printable media. |
Schedule | If part of a schedule, links to other events in the series. |