Sweeppea icon

Sweeppea

Interact with the Sweeppea API

Actions15

Winner → Draw

AI-generated

Summary

Draws one or more winners from a Sweeppea sweepstake using weighted random selection, by calling the Sweeppea API's /winners/draw endpoint.

Inputs

  • Sweepstakes Token (required) — UUID token that identifies the sweepstake to draw from.
  • How Many Winners — Number of winners to select. Minimum 1, default 1.
  • Additional Fields — Optional collection of draw filters. These are sent as-is in the request body: Completed Entries Only (only participants who finished all bonus entry steps), Exclude Spam Participants (skip participants flagged as spam), Group (a group token to limit the draw, default "allgroups"), and Include Opted-Out Participants (include participants who opted out of notifications). Booleans default to false.

Output shape

One output item per input item, holding the raw JSON response from the Sweeppea draw endpoint. Each item is paired to its input item.

The node does not reshape the response, so the winner fields depend on the API. Unlike Winner > Get Many, the draw result is not split into one item per winner. The operation runs once for each input item, so multiple input items trigger multiple draws. API errors (404 for an unknown token, 400 for validation failures) are raised as node errors. With Continue On Fail enabled, the API error body or an error message is returned as the item instead.

Examples

Example 1: Pick a single grand-prize winner when a sweepstake closes.

Set Sweepstakes Token to the sweepstake UUID and leave How Many Winners at 1. Under Additional Fields, enable Exclude Spam Participants.

Example 2: Draw 5 winners from only the participants who completed every bonus entry step.

Set How Many Winners to 5. Under Additional Fields, enable Completed Entries Only and Exclude Spam Participants.

Links

Discussion