Sweeppea icon

Sweeppea

Interact with the Sweeppea API

Actions15

Participant → Get

AI-generated

Summary

Fetches a single participant from a Sweeppea sweepstake by email, phone number, or participant token, and returns the API's participant record.

Inputs

  • Sweepstakes Token (required) — UUID token of the sweepstake to search in. Sent as SweepstakesToken.
  • Search By — Which identifier to look up: Email (default), Phone Number, or Participant Token.
  • Email (required) — Participant's email address. Shown and used only when Search By is Email.
  • Phone Number (required) — Participant's 10-digit phone number with no separators. Shown and used only when Search By is Phone Number.
  • Participant Token (required) — Participant's UUID v4 token. Shown and used only when Search By is Participant Token.

Output shape

One output item per input item, containing the JSON response from the Sweeppea API's POST /participants/single endpoint, paired to the input item.

The exact fields of the participant record are defined by the API and aren't visible in the node source. Errors: a 404 is reported as 'Sweepstake not found' and a 400 returns the API's validation message. With Continue On Fail enabled, the API's error body, or a {Response:false, Message, itemIndex} object, is returned instead of stopping the workflow. Requires Sweeppea API credentials.

Examples

Example 1: Check whether a lead who submitted a form has already entered the sweepstake, using their email.

Sweepstakes Token = your sweepstake UUID; Search By = Email; Email = {{ $json.email }}

Example 2: Retrieve a participant's record from an SMS entry by phone number.

Search By = Phone Number; Phone Number = 5551234567

Example 3: Load full details of a participant whose token was stored earlier.

Search By = Participant Token; Participant Token = {{ $json.participantToken }}

Links

Discussion