# 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](https://www.attend.vip/help/agents/build-the-schedule.md)
- Attend MCP tools: `agenda_items__getScheduleBundle`, `agenda_items__createAgendaGroup`, `agenda_items__updateAgendaGroup`, `agenda_items__duplicateAgendaGroup`, `agenda_items__createAgendaActivity`, `agenda_items__updateAgendaActivity`, `agenda_items__getActivityDetail`, `agenda_items__createAgendaItem`, `agenda_items__updateAgendaItem`
- Updated: 2026-11-02

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…](https://www.attend.vip/help/agents/message-people-who.md).
