CalendarEvents
Search CalendarEvents
Search and list CalendarEvent records with filtering, sorting, and pagination.
GET
Search CalendarEvents
An event (CalendarEvent) is a physical, virtual, or hybrid event published on the Members Portal. Events can be free or monetised with ticket products. Physical events can be linked to a bookable resource, which blocks that resource from being booked for the event’s duration. Virtual events use the Zoom integration for conference calls or webinars. Events support recurring series: set RepeatEvent = true on creation with Repeats, RepeatEvery, RepeatUntil, and the day-of-week flags; all repeat-configuration fields are create-only, and WhichEventsToUpdate controls the scope of updates or deletions to an existing series. Attendance can be restricted by customer type (OnlyForContacts, OnlyForMembers), plan, team, or specific customers. Set Allocation to cap total attendees and EnableWaitList to allow overflow sign-ups. Events with registered attendees cannot be deleted.
Authentication
This endpoint requires OAuth2 authentication. Include a valid bearer token in the
Authorization header.
The authenticated user must be a full unrestricted administrator or have the CalendarEvent-List role.Enums
eCalendarEventRepeatCycle — Repeats values
eCalendarEventRepeatCycle — Repeats values
eRepeatedCalendarEventUpdateAction — WhichEventsToUpdate values
eRepeatedCalendarEventUpdateAction — WhichEventsToUpdate values
Query Parameters
Pagination & Sorting
integer
default:"1"
The page number to retrieve.
integer
default:"25"
The number of records per page.
string
The property name to sort results by (e.g.
Name, CreatedOn).integer
Sort direction.
0 for ascending, 1 for descending.Filters
integer
Filter by iD of the location this event belongs to..
string
Filter by name of the event displayed on the Members Portal; required..
string
Filter by full name of the person hosting or presenting the event..
string
Filter by short plain-text summary shown under the event name on the Members Portal..
string
Filter by full HTML description shown when a customer opens the event on the Members Portal..
string
Filter by additional notes appended to ticket confirmation emails..
boolean
Filter by whether customers can join a waiting list when the event is at full capacity..
boolean
Filter by whether to request the buyer’s postal address during ticket checkout..
boolean
Filter by whether the attendee list is displayed on the Members Portal event page..
string
Filter by venue or room name displayed on the event page; changing it notifies registered attendees..
string
Filter by street address of the event venue..
integer
Filter by optional ID of the bookable resource held for this event; it blocks that resource from being booked during the event’s start and end times..
string
Filter by display value for Resource.Name..
string
Filter by event start date and time in UTC; must be before EndDate..
string
Filter by event end date and time in UTC; must be after StartDate..
integer
Filter by maximum total number of attendees for the event; leave empty for unlimited. The effective capacity is the lower of this value and the sum of the ticket products’ allocations..
string
Filter by uTC date and time the event becomes visible on the Members Portal; the system rounds it down to the nearest 15 minutes. Leave empty to keep the event unpublished..
boolean
Filter by whether this event is displayed in the home page banner on the Members Portal..
boolean
Filter by whether this event is displayed on the Members Portal home page..
boolean
Filter by whether customers can post comments on the event..
boolean
Filter by whether the system creates a Zoom conference call for this event and shares the link with attendees..
boolean
Filter by whether to create a Zoom webinar instead of a regular conference call for this event..
string
Filter by comma-separated email addresses of alternative Zoom hosts who can start the webinar..
string
Filter by internal raw Zoom meeting payload maintained by the Zoom integration..
string
Filter by internal Zoom meeting or webinar identifier maintained by the Zoom integration..
boolean
Filter by whether only customers without an active contract (contacts) can view and attend this event..
boolean
Filter by whether only customers with an active contract (members) can view and attend this event..
string
Filter by filename of the small event image shown in related-events sections (read-only; set via
NewSmallLogoUrl).string
Filter by uRL of an image to upload as the small event image.
boolean
Filter by remove the current small event image.
string
Filter by filename of the large event image shown on the event list and detail page (read-only; set via
NewLargeLogoUrl).string
Filter by uRL of an image to upload as the large event image.
boolean
Filter by remove the current large event image.
string
Filter by optional URL of an external website related to this event..
string
Filter by optional URL of a Facebook event or page for this event..
string
Filter by optional URL of an external ticketing page for this event..
string
Filter by system-generated identifier shared by all occurrences in a recurring series; use it to find and update all events in that series..
boolean
Filter by whether to create this event as a recurring series; only applies when creating the first event in the series..
integer
Filter by recurrence cycle for the series: Daily, Weekly, Monthly, Yearly, FirstOfMonth, SecondOfMonth, ThirdOfMonth, FourthOfMonth, or LastOfMonth..
integer
Filter by for an update to a recurring event, selects the scope: UpdateThisEventOnly, UpdateFutureEventsOnly, UpdateAllEvents, DeleteAllEvents, DeleteEventsAfterThis, or UpdateEventProducts..
integer
Filter by optional positive number of cycles between occurrences; for example, 2 with Weekly repeats every two weeks..
string
Filter by optional final UTC date for creating occurrences in the recurring series; when omitted, occurrences are created for one year..
boolean
Filter by whether the recurring series includes Mondays..
boolean
Filter by whether the recurring series includes Tuesdays..
boolean
Filter by whether the recurring series includes Wednesdays..
boolean
Filter by whether the recurring series includes Thursdays..
boolean
Filter by whether the recurring series includes Fridays..
boolean
Filter by whether the recurring series includes Saturdays..
boolean
Filter by whether the recurring series includes Sundays..
string
Filter by system-maintained local-time representation of StartDate; set StartDate (UTC) instead..
string
Filter by system-maintained local-time representation of EndDate; set EndDate (UTC) instead..
string
Filter by system-maintained local-time representation of PublishDate; set PublishDate (UTC) instead..
string
Filter by internal background job identifier for the scheduled post-event notification email..
boolean
Filter by whether a follow-up notification email is sent to all attendees after the event ends..
string
Filter by custom message body for the post-event notification email..
boolean
Filter by whether a reminder email is sent to attendees within 24 hours before the event starts..
boolean
Filter by whether a form is linked to this event that attendees are asked to complete; the system sets this automatically from FormPage..
boolean
Filter by whether the linked event form is sent to attendees by email, including follow-up reminders..
integer
Filter by optional ID of the form page attendees are asked to complete for this event..
string
Filter by display value for FormPage.Name..
string
Filter by read-only display names of the plans this event is restricted to; change the Tariffs collection instead..
string
Filter by read-only display names of the teams this event is restricted to; change the Teams collection instead..
string
Filter by read-only display names of the customers this event is restricted to; change the Members collection instead..
Range Filters
string
Filter by event start date and time in UTC; must be before EndDate. greater than or equal to this value. Format:
YYYY-MM-DDTHH:mm.string
Filter by event start date and time in UTC; must be before EndDate. less than or equal to this value. Format:
YYYY-MM-DDTHH:mm.string
Filter by event end date and time in UTC; must be after StartDate. greater than or equal to this value. Format:
YYYY-MM-DDTHH:mm.string
Filter by event end date and time in UTC; must be after StartDate. less than or equal to this value. Format:
YYYY-MM-DDTHH:mm.integer
Filter by maximum total number of attendees for the event; leave empty for unlimited. The effective capacity is the lower of this value and the sum of the ticket products’ allocations. greater than or equal to this value.
integer
Filter by maximum total number of attendees for the event; leave empty for unlimited. The effective capacity is the lower of this value and the sum of the ticket products’ allocations. less than or equal to this value.
string
Filter by uTC date and time the event becomes visible on the Members Portal; the system rounds it down to the nearest 15 minutes. Leave empty to keep the event unpublished. greater than or equal to this value. Format:
YYYY-MM-DDTHH:mm.string
Filter by uTC date and time the event becomes visible on the Members Portal; the system rounds it down to the nearest 15 minutes. Leave empty to keep the event unpublished. less than or equal to this value. Format:
YYYY-MM-DDTHH:mm.integer
Filter by optional positive number of cycles between occurrences; for example, 2 with Weekly repeats every two weeks. greater than or equal to this value.
integer
Filter by optional positive number of cycles between occurrences; for example, 2 with Weekly repeats every two weeks. less than or equal to this value.
string
Filter by optional final UTC date for creating occurrences in the recurring series; when omitted, occurrences are created for one year. greater than or equal to this value. Format:
YYYY-MM-DDTHH:mm.string
Filter by optional final UTC date for creating occurrences in the recurring series; when omitted, occurrences are created for one year. less than or equal to this value. Format:
YYYY-MM-DDTHH:mm.string
Filter by system-maintained local-time representation of StartDate; set StartDate (UTC) instead. greater than or equal to this value. Format:
YYYY-MM-DDTHH:mm.string
Filter by system-maintained local-time representation of StartDate; set StartDate (UTC) instead. less than or equal to this value. Format:
YYYY-MM-DDTHH:mm.string
Filter by system-maintained local-time representation of EndDate; set EndDate (UTC) instead. greater than or equal to this value. Format:
YYYY-MM-DDTHH:mm.string
Filter by system-maintained local-time representation of EndDate; set EndDate (UTC) instead. less than or equal to this value. Format:
YYYY-MM-DDTHH:mm.string
Filter by system-maintained local-time representation of PublishDate; set PublishDate (UTC) instead. greater than or equal to this value. Format:
YYYY-MM-DDTHH:mm.string
Filter by system-maintained local-time representation of PublishDate; set PublishDate (UTC) instead. less than or equal to this value. Format:
YYYY-MM-DDTHH:mm.string
Filter records created on or after this date. Format:
YYYY-MM-DDTHH:mm.string
Filter records created on or before this date. Format:
YYYY-MM-DDTHH:mm.string
Filter records updated on or after this date. Format:
YYYY-MM-DDTHH:mm.string
Filter records updated on or before this date. Format:
YYYY-MM-DDTHH:mm.Code Examples
Simple listing
Filtering by Name
Range filters
Response
200
CalendarEvent[]
The list of CalendarEvent records matching the query. See the Get one CalendarEvent endpoint for the full list of properties returned for each record.
integer
Current page number.
integer
Number of records per page.
string
The field used for sorting.
integer
The sort direction (
0 = ascending, 1 = descending).integer
Index of the first item on the current page.
integer
Index of the last item on the current page.
integer
Total number of matching records across all pages.
integer
Total number of pages.
boolean
Whether there is a next page of results.
boolean
Whether there is a previous page of results.
Example Response