CrowdHum

Add another poll to an EXISTING CrowdHum session by its room code (e.g. "add a sentiment poll to room XKCD") — CrowdHum's one-QR-many-polls model. The new poll shares the same room code and links. You must own the session. Adding to a session that already has a live poll does NOT switch the screen — the presenter activates it when ready. Same poll fields as create_poll.

add_poll_to_session

Create a CrowdHum poll in a NEW session + room code that voters can immediately use. Returns the room code plus the voter and presenter URLs. To add another poll to an EXISTING room instead, use add_poll_to_session. Call list_visualizations first to choose visualization.mode. Choice-based modes (column-drift, rising-bubbles, ranking) need 2-6 choices; word-cloud, grid-2x2, and qa (Q&A) need none. For qa you may optionally pass `qaSettings` { moderation: 'auto'|'pending', upvoting: 'on'|'off' } (defaults: auto + on). IMPORTANT: `title`, `choices`, and `visualization` are all TOP-LEVEL parameters — do NOT nest `choices` or `title` inside `visualization`. Example for a choice-based poll: { "title": "How did you get here?", "visualization": { "mode": "rising-bubbles" }, "choices": [ { "id": 1, "label": "Bike" }, { "id": 2, "label": "Walked" } ] } Example for word-cloud (no choices): { "title": "One word for this team", "visualization": { "mode": "word-cloud" } } Do NOT pass a room code here — create_poll ALWAYS makes a new room. To add a poll to an EXISTING room, use add_poll_to_session instead.

create_poll

Get vote results for a poll in a room (by room code). Returns the recorded vote count and a per-option tally. By default it reads the ACTIVE poll; pass `poll` (a 1-based number matching the order shown by get_session) to read a specific poll. For an ENDED run it shows the final frozen results; for a still-LIVE run it aggregates the current votes (choice totals, 2D quadrant counts, Borda ranking points, or grouped word responses). For a Q&A poll it returns the question count, total upvotes, answered count, and the top questions by upvote. You must own the session.

get_poll_results

Fetch the AI-generated recap for a session (by room code), if one has been generated, with the per-poll insight summary. Fetch-only — it does not generate a recap. You must own the session.

get_session_recap

Show a session (event) and the polls in it, by room code — title, live/idle, voter/presenter links, and each poll's title, mode, and recorded vote count. Use this to see what's in a room before adding polls.

get_session

Return the voter and presenter URLs for an existing room code. The voter URL is what the room's QR code encodes; the QR image itself is rendered on the presenter screen, not returned here.

get_room_links

Grant co-ownership of a session (by room code) to another CrowdHum user by email, so they can co-edit and co-present it. You must OWN the session (co-owners cannot invite further co-owners). The invitee must already have a CrowdHum Pro account; they are notified by email. Idempotent — re-inviting an existing co-owner is a no-op.

invite_co_owner

List the polls you own, newest first — with visualization mode, room code, and title.

list_my_polls

List the CrowdHum sessions (events) you own, newest first — room code, title, whether it's currently live, poll count, and recap status. Use this to find a session by name (e.g. 'my Copenhagen session') and get its room code for add_poll_to_session, get_session, or get_session_recap.

list_my_sessions

List CrowdHum's visualization modes with guidance on when to use each (bestFor, ideal choice count, example questions, anti-patterns). Call this before create_poll to choose visualization.mode.

list_visualizations