Skip to content
Docs

Group events

A group event type is a class, workshop or office hour with a fixed number of seats. You schedule sessions of it, and each invitee books one seat. Seats are ordinary bookings that carry a sessionId.

Create a group type

In the dashboard, create an event type and choose the group kind. Set its duration and a default capacity. Every new session starts with that capacity, and you can change it per session.

Schedule sessions

Add a session by choosing the event type and a start time. To repeat it, set a number of weekly repeats (up to 26). The sessions of a repeating series share a seriesId.

You can do the same with the CLI (devalender sessions) or the group sessions API.

Capacity

Capacity is the number of seats, set per session. A session that is full stops showing as bookable, and a booking that loses the race for the last seat gets a 409 conflict. Lowering capacity below the seats already taken is rejected.

What attendees get

Each attendee receives a confirmation email with a link to manage their seat, where they can cancel it.

Move or cancel a session

Change a session's start time or capacity from the dashboard, the CLI or the API. Cancelling cancels each seat and emails the attendees. Cancel one session, or this one and every later session in its series.

Each change reaches your webhooks: session.created, session.updated, session.cancelled, and a booking.cancelled per seat.

Embed the schedule

Put the upcoming sessions on your own site with the calendar element; see Schedule calendar. Visitors book a seat without leaving the page.