Prize Draw API
Create custom prize campaigns with flexible rules, multiple prize tiers, and automated winner selection. Fair, auditable, UK fundraising ready.
What It Does
Complete API for managing custom prize campaigns from setup through winner notification.
Flexible Prize Tiers
Cash, physical items, experiences, or bundles. Multiple tiers per draw (1 grand prize + runners-up).
Custom Entry Rules
Minimum spend, quantity limits, geographic restrictions, previous winner exclusions.
Eligibility Validation
Custom business rules. E.g., "enter if you attended last 3 events."
Fair Selection
Cryptographically secure random number generator. Each ticket is one equal chance.
Automated Notifications
Email, SMS, or in-app. Customizable templates. Social sharing tools.
Prize Refusal Handling
Auto-select next winner if declined. Configurable backup options.
How It Works
Create Draw
Define prizes, entry rules, eligibility criteria, and timing.
Open Entry
Supporters enter and purchase tickets. Real-time validation applied.
Select Winners
Trigger draw at deadline. A cryptographically secure random number generator selects fair winners.
Announce & Notify
Winners notified. Optional public announcement. Audit trail created.
Key Endpoints & Capabilities
Complete prize draw management from creation to winner fulfillment.
/draws/create
Define prizes, rules, timing. Configure notifications and tie-breaking.
/draws/entries
Validate and log entries. Apply eligibility rules. Track entry sources.
/draws/winners
Execute draw with a cryptographically secure random number generator. Handle refusals and auto-select backups.
/draws/extend
Extend deadlines. Update rules. Add prizes. Changes fully logged.
/draws/analytics
Entry volume, conversion rates, prize performance. Exportable reports.
Want to connect your own systems? Book a demo and we will talk you through what is available today.
Security & Reliability
Fair Selection
Cryptographically secure random number generator; every draw’s selection is recorded and can be independently checked.
Duplicate Prevention
Automatic detection of multiple entries. Configurable handling.
Checkable Results
Each selection is kept in an append-only record with the random numbers used, so it can be re-run and checked.
Rule Enforcement
Eligibility rules strictly enforced. Cannot override or bypass.
Compliance Reporting
Tax records. Prize value documentation. Regulatory audit trails.
Integrations & Webhooks
Webhooks for real-time notifications. Integrations with email, SMS, and custom systems.
Winner Notifications
Email, SMS, or in-app notifications. Customizable templates.
Public Announcements
Public winner announcement pages. Social media sharing tools.
Mailchimp Integration
Add winners to email lists. Trigger automated sequences.
Twilio SMS
Send winner notifications via SMS. Claim links included.
Frequently Asked Questions
What is the Prize Draw API?+
Manage custom prize campaigns. Define prizes, entry mechanics, eligibility rules, and winner selection. Handles entry validation, duplicate prevention, and automated winner notification.
What prize types are supported?+
Cash prizes, physical items, experience packages, ticket bundles. Multiple prize tiers (e.g., 1 grand prize + 10 runner-up prizes). Combine prizes in single draw.
How do I set entry rules?+
Minimum purchase amount • Ticket quantity limits • Geographic restrictions • Previous winner exclusions • Custom business rules (e.g., 'enter if you attended last 3 events'). All configurable.
Can I extend a draw deadline?+
Yes. Update draw details anytime before selection. Extend deadline, add prizes, change eligibility rules. Changes logged for audit. New entries reflected immediately.
How do I announce winners?+
Automated email, SMS, or in-app notifications. Optional: public announcement page with winner names and prize info. Social media sharing tools included.
What if a winner declines their prize?+
API supports prize refusal. Auto-select next winner in line, or redraw. Supporter opt-out options. Full audit trail of all changes.
Can I run recurring prize draws?+
Yes. Template-based recurring draws. E.g., 'draw a $100 prize every week.' Automatic scheduling, entry reset, and winner selection. Zero manual effort.
How does fair selection work?+
Winners are picked with a cryptographically secure random number generator. Each ticket is one chance, so more tickets means more chances. Every draw's selection is recorded and can be independently checked.
Can I export entry data?+
Yes. CSV or JSON export of all entries, exclusions applied, winner data.
What are typical draw sizes?+
Draws of every size use the same selection: one random number per prize, from the tickets in the draw. We do not publish a speed figure.