Choice groups and activities

Let guests pick one option per time slot, or pick a set number of times for an activity, and move sessions between groups safely.

Do first
Build and publish the schedule

Attend has two separate ways to give guests a choice. A session can belong to either, both or neither.

  • A choice group is one time slot with several options, for example “Saturday 2 pm: spa, hike or pool”. Guests pick from the group.
  • An activity is one thing offered at several times, with a per-guest limit, for example “Catamaran tour at 9 am, 11 am or 2 pm; go once”.

Choice group steps

  1. Read the existing groups and activities in agenda_items__getScheduleBundle, so you extend them rather than duplicating them.
  2. Create the group with agenda_items__createAgendaGroup:
    • selectionRule: "one": pick exactly one. Confirming one option releases the others. Use this for options at the same time.
    • selectionRule: "multi": independent options. Use it only when options don’t overlap.
    • allowNone: true (pick-one only) adds “None of these”. With allowNone: false, guests must choose.
    • startsAt/endsAt give the slot time. Guests see the options, not the group name.
  3. Create each option with agenda_items__createAgendaItem, passing the group’s groupId. Options are usually rsvpMode: "rsvp" so capacity applies.
  4. Copy a group for the next day with agenda_items__duplicateAgendaGroup. It copies the group and its options with new names; dry-run it first.
  5. Change the group with agenda_items__updateAgendaGroup. shiftChildren: true moves the options’ times with the group’s time.

Activity steps

  1. Create it with agenda_items__createAgendaActivity. minPerAttendee and maxPerAttendee set how many of its times each guest must or may confirm: maxPerAttendee: 1 means “pick one time”.
  2. Create each time with agenda_items__createAgendaItem, passing activityId.
  3. Change the limits with agenda_items__updateAgendaActivity. Dry-run first: lowering maxPerAttendee below what guests have already confirmed is refused.
  4. Check sign-ups with agenda_items__getActivityDetail, passing one session’s agendaItemId. It returns the RSVP counts, the participants, the session’s to-dos and its chat channel.

Move a session to another group

Use agenda_items__updateAgendaItem with a new groupId, or null to take the session out of every group. Always dry-run. The dry-run returns a groupMove plan:

  • In a pick-one target group, a guest who already chose another option there keeps that choice, and their place on the moved session is released. The plan lists them.
  • sourceGroupLeftWithoutPick lists guests whose only pick in the old group was this session; they now have no choice there.
  • Waitlisted and pending RSVPs are not treated as conflicts.

Read the plan back to the organizer as names and counts, and get a yes before you run it for real. Without position, the session goes to the end of the target group.

Then

To nudge guests who haven’t chosen yet, use the agenda_unanswered condition in Message people who….

Updated 2026-11-02 · View as Markdown