Random Winner API
Automated fair winner selection. Handles exclusions, eligibility rules, and notifications. Fully auditable and dispute-proof.
What It Does
Automate winner selection with configurable rules and notifications.
Fair Selection
Uses a cryptographically secure random number generator. Each ticket is one equal chance.
Exclusion Rules
Exclude previous winners, staff, or custom criteria. Rules fully configurable.
Eligibility Checks
Validate purchase amounts, participation dates, or custom business rules.
Auto Notifications
Email, SMS, or webhook alerts. Customizable templates. Unsubscribe links included.
Audit Trails
Immutable records of every selection, kept for your records.
How It Works
Upload List
Provide supporter list with emails and optional metadata.
Configure Rules
Set exclusions, eligibility criteria, and selection parameters.
Select Winners
API uses a cryptographically secure random number generator to fairly select winners based on rules.
Notify & Audit
Winners notified. Audit trail created. Results immutable.
Key Endpoints & Capabilities
Core winner selection endpoints. All operations fully auditable.
/winners/select
Select winner(s) from supporter list. Configure exclusions and rules.
/winners/notify
Send winner notifications. Email, SMS, or custom webhook.
/winners/validate
Pre-check if supporter is eligible. Verify before selection.
/winners/history
Query all previous selections. Filter by campaign or date.
Want to connect your own systems? Book a demo and we will talk you through what is available today.
Security & Reliability
Fair RNG
Cryptographically secure random number generator; every draw’s selection is recorded and can be independently checked.
Checkable Results
Each selection is kept in an append-only record with the random numbers used, so it can be re-run and checked.
Deduplication
Automatic detection and handling of duplicate entries.
Compliance Logging
All selections logged. Accessible by regulators. GDPR compliant.
Exclusion Enforcement
Rules strictly enforced. Cannot override or bypass exclusions.
Integrations & Webhooks
Send notifications via email, SMS, or webhooks. Integrates with Mailchimp, Twilio, and custom systems.
Email Notifications
Customizable email templates. Automated delivery. Unsubscribe links.
SMS Notifications
Twilio integration. SMS delivery to winners with claim links.
Webhook Notifications
Custom webhooks for winner events. Real-time notifications to your backend.
Mailchimp Integration
Add winners to Mailchimp lists. Trigger email sequences.
Frequently Asked Questions
What is the Random Winner API?+
Automated winner selection from supporter lists. Handles fair randomization, duplicate removal, eligibility checks, and winner notification. Integrates with your supporter database.
How does winner selection work?+
You provide a list of eligible supporters. Duplicates are removed, then a cryptographically secure random number generator picks the winners. Every draw's selection is recorded and can be independently checked.
Can I exclude specific supporters?+
Yes. Exclusion lists, eligibility filters, and custom rules supported. E.g., exclude previous winners, staff, or specific geographic regions. Rules fully configurable.
Does it auto-notify winners?+
Yes. Send automated emails, SMS, or webhooks to winners. Customizable templates. Unsubscribe links included. Integrates with Mailchimp, Twilio, or custom systems.
What data do I need to provide?+
Supporter list (email, name, optional metadata). Campaign ID. Winner count. Optional: exclusion rules, eligibility criteria, notification preferences.
How long does selection take?+
Winners are picked when the draw closes, as part of closing it. We do not publish a speed figure.
Can winners be disputed?+
Every draw's selection is recorded: the inputs, the random numbers used and the winners. So if a result is questioned, it can be independently checked.
What if two supporters have the same email?+
API flags duplicates. You can deduplicate before submission, or use API's automatic duplicate removal (keeps first entry). Fully logged for audit.
Can I re-draw if needed?+
Talk to us first. There is no random seed to change: every selection uses fresh numbers from a cryptographically secure random number generator, and earlier selection records are kept and can never be edited or deleted.
Is there a cost per draw?+
No. Included with all platform plans. Unlimited draws. No per-transaction fees for API usage.