Draw winners from a sweepstakes immediately. Use fetch_sweepstakes first to get the sweepstakes_token, and fetch_groups to get available groups. CRITICAL: This is a production operation that selects real winners. ALWAYS confirm with the user before drawing — including the number of winners and which group to draw from. Uses weighted random selection favoring participants with bonus entries. Cannot draw from paused or archived sweepstakes. Use them internally for tool chaining but present only human-readable information (names, emails).
# draw_winners
## When to use
Draw winners from a sweepstakes immediately. Use fetch_sweepstakes first to get the sweepstakes_token, and fetch_groups to get available groups. CRITICAL: This is a production operation that selects real winners. ALWAYS confirm with the user before drawing — including the number of winners and which group to draw from. Uses weighted random selection favoring participants with bonus entries. Cannot draw from paused or archived sweepstakes. Use them internally for tool chaining but present only human-readable information (names, emails).
## Pre-calls required
1. fetch_sweepstakes if the user gave you a sweepstakes name instead of a token
2. fetch_rules(sweepstakes_token) — confirm Official Rules exist (drawing is illegal without them)
3. count_participants — verify there are enough entries for the requested winners count
4. Confirm the entry period has ended for the relevant drawing window
## Parameters to validate before calling
- sweepstakes_token (string, required) — The sweepstakes token (UUID format)
- how_many_winners (number, required) — Number of winners to pick (must be >= 1)
- group (string, required) — Group token to draw from, or "allgroups" for all participants
- completed_entries (boolean, optional) — Only include participants with completed entries (default: true)
- include_opted_out (boolean, optional) — Include participants who opted out (default: false)
- exclude_spam (boolean, optional) — Exclude flagged spam participants (default: true)
## Notes
- After drawing: fetch_winners to confirm, update the campaign brief note, create a calendar event for winner notification deadline
- Remind the user about web-interface steps: classify winners, send notifications, publish Winners List