Integration Guide
FanFest integrates with your platform at three levels. Each tier builds on the one before it, so you can start simple and add capabilities as your needs grow.
EmbedDrop-in fan engagement widget for any website. | SSOIdentify users across your platform and FanFest. | FullTwo-way loyalty sync between your backend and FanFest. |
|---|---|---|
| Live shows and contests | Everything in Embed | Everything in SSO |
| Chat and reactions | User identification (OIDC) | Loyalty points egress (webhooks) |
| Brand customization | Cross-platform event tracking | REST API access |
| No backend changes needed | Personalized engagement | Multi-resolution data export |
| Get Started | Set Up SSO | Learn More |
- Live shows and contests
- Chat and reactions
- Brand customization
- No backend changes needed
- Everything in Embed
- User identification (OIDC)
- Cross-platform event tracking
- Personalized engagement
- Everything in SSO
- Loyalty points egress (webhooks)
- REST API access
- Multi-resolution data export
Choosing the Right Tier
Start with Embed when you want fan engagement on your site with zero backend work. Add SSO when you need to identify users across your platform and FanFest. Add Full Backend when you need two-way loyalty data sync between systems.
Feature Matrix
The table below provides a detailed breakdown of what each integration tier unlocks.
| Capability | Embed | SSO | Full Backend |
|---|---|---|---|
| Fan engagement widget | Yes | Yes | Yes |
| Live shows and streaming | Yes | Yes | Yes |
| Contests (quizzes, raffles, polls) | Yes | Yes | Yes |
| Real-time chat and reactions | Yes | Yes | Yes |
| Brand customization and theming | Yes | Yes | Yes |
| Leaderboards and points display | Yes | Yes | Yes |
| User identification (OIDC) | Yes | Yes | |
| Cross-platform event tracking | Yes | Yes | |
| Personalized engagement | Yes | Yes | |
| Cross-platform analytics | Yes | Yes | |
| Loyalty points egress (webhooks) | Yes Full | ||
| REST API access | Yes Full | ||
| Webhook notifications | Yes Full | ||
| Multi-resolution data export | Yes Full |
Closed Beta
The Full Backend integration tier is currently in Closed Beta. Webhook notifications, REST API access, and loyalty points egress are available to select partners. Contact us for access.
Architecture Overview
The following diagram shows how the three integration tiers relate to each other and to the FanFest platform.
Tier Details
Tier 1: Embed
The fastest way to add FanFest to your site. Add a script tag, initialize the SDK with your clientId, and you have a fully functional fan engagement widget. No backend changes required.
- Time to integrate: Under 5 minutes
- Requirements: A FanFest channel and a website
- What you get: Shows, contests, chat, reactions, leaderboards, and full brand theming
Get started with the Embed | Embed deep-dive
Tier 2: SSO (Recommended)
Connect your identity provider so FanFest recognizes your users. This enables cross-platform tracking, personalized engagement, and analytics that tie FanFest activity back to your user base.
- Time to integrate: 1-2 hours
- Requirements: An OIDC-compatible identity provider (Auth0, Okta, Azure AD, etc.)
- What you add: User identification, event tracking, cross-platform analytics
Tier 3: Full Backend Closed Beta
Two-way data sync between your backend systems and FanFest's loyalty engine. Receive real-time webhook notifications when users earn points, or pull loyalty data on demand via the REST API. Choose your data granularity: aggregated totals, daily breakdowns, or individual action records.
- Time to integrate: 1-2 days
- Requirements: SSO integration, API key with
loyalty:readpermission, HTTPS webhook endpoint - What you add: Loyalty points egress, webhook notifications, REST API access, configurable resolution modes
Loyalty integration | API reference
Next Steps
Already have an embed running? Here is where to go next:
- Add SSO to identify your users across platforms
- Set up event tracking to capture engagement data
- Explore the API reference for the complete SDK and API surface