UniFi + CaptiveWiFi Integration

Turn every UniFi
guest login into data.

Connect your UniFi network to CaptiveWiFi in under 30 minutes. Built on the latest Ubiquiti UniFi Network API, every guest who joins your WiFi becomes a verified customer record — with consent, email, and marketing permissions captured automatically.

UniFi Access Point
Guest SSID broadcasting
Active
Guest connects
CaptiveWiFi portal loads
Captured
CRM record created
Email, consent, visit data
Syncing
Why CaptiveWiFi + UniFi

Everything your UniFi network
was missing.

UniFi is the world's most popular hospitality WiFi hardware. CaptiveWiFi turns it into a first-party data platform.

Guest identity at the point of connection
Every device that connects to your UniFi guest SSID is prompted to identify themselves. Name, email and marketing consent captured in seconds.
Real-time visit intelligence
See who is in your venue right now. New guest or returning? First visit this week or tenth this month? CaptiveWiFi tells you instantly.
Branded portal, your design
The guest portal matches your brand exactly. Logo, colours, fonts, imagery. No Ubiquiti branding. No generic splash page.
GDPR-compliant data capture
Every guest record includes a full consent audit trail. Opt-in, timestamp, IP address, and the exact wording they agreed to. Built for UK and EU compliance.
Automatic marketing triggers
Connect CaptiveWiFi to Klaviyo, Mailchimp, or your CRM. First visit, return visit, lapsed guest — each triggers the right campaign automatically.
Built on the latest Ubiquiti UniFi Network API
CaptiveWiFi uses the current UniFi Network API — not legacy workarounds. API key authentication, full Site Manager support, and compatibility with all current UniFi hardware including UDM, UDM Pro, UDM-SE, Dream Router, and all Access Point models.
How it works

From connection to
customer record in seconds.

1
Guest joins your WiFi
Your UniFi AP broadcasts a guest SSID. The guest selects it and is redirected to your CaptiveWiFi portal.
2
Branded portal loads
Your custom portal appears. Name, email, and marketing consent are requested. The guest accepts in seconds.
3
Access is granted
CaptiveWiFi instructs the UniFi controller to authorise the device. The guest is online in under 10 seconds.
4
Data flows automatically
The guest record is created or updated. Integrations fire. Visit history, return rate, and CRM data update in real time.
Setup guide

Up and running in
under 30 minutes.

No technical team required. If you can log into your UniFi controller, you can complete this setup.

1
Create your CaptiveWiFi account
Sign up at captivewifi.com. Create your venue profile and design your guest portal. Free plan available, no card needed.
2
Select UniFi as your hardware
In your CaptiveWiFi dashboard, select UniFi as your access point type. You will receive your portal URL and configuration settings.
3
Follow the setup guide
Our Help Centre has step-by-step UniFi configuration instructions covering all hardware models including UDM, UDM Pro, Dream Router and self-hosted controllers.
4
Go live in under 30 minutes
Connect a device to your guest SSID to test. The portal loads, captures the guest record, and grants access within seconds.
Full documentation, screenshots and troubleshooting in our Help Centre.
UniFi Network API Integration
# Uses the latest Ubiquiti
# UniFi Network API (v2)

Auth Method: API Key (Site Manager)
Portal Type: External Captive Portal
Landing Page URL:
  https://portal.captivewifi.com
  /[your-venue-id]

Guest Auth Endpoint:
  https://api.captivewifi.com
  /auth/unifi/v2

# API Key and Site ID provided
# in CaptiveWiFi dashboard
# under Hardware > UniFi
Need help with setup?
Our team has configured CaptiveWiFi on hundreds of UniFi networks. Book a free 15-minute call and we will walk through it with you.
View setup guide
Compatibility

Works with your
existing UniFi hardware.

No new hardware required. CaptiveWiFi integrates via the latest Ubiquiti UniFi Network API, and works with every current UniFi gateway and access point model.

UniFi Dream Machine (UDM)
UniFi Dream Machine Pro (UDM-Pro)
UniFi Dream Machine SE
UniFi Dream Router (UDR)
UniFi Security Gateway (USG)
UniFi Network Controller (self-hosted)
UniFi Cloud Key Gen2
UniFi Access Points (all models)
UniFi Network Application (UI)
FAQ

Common questions about
UniFi + CaptiveWiFi.

Does CaptiveWiFi replace the UniFi built-in portal?
Yes. CaptiveWiFi replaces the default UniFi Hotspot portal with your own branded experience. UniFi still handles all the network-level access control — CaptiveWiFi sits in front of it and handles the guest-facing portal, data capture, and marketing integrations.
Do I need a UniFi Cloud account or self-hosted controller?
CaptiveWiFi works with both. Whether you use UniFi's hosted cloud platform or run your own UniFi Network Application on a local server or VPS, the integration works the same way.
Will this work on my existing guest SSID?
Yes. You configure CaptiveWiFi on your existing guest network. No need to change your SSID name, password structure, or VLAN setup.
Is this GDPR compliant?
Yes. CaptiveWiFi is fully GDPR and UK GDPR compliant. Every guest record includes a consent timestamp, the exact consent wording displayed, IP address, and opt-in status. A full DPIA is available on request.
What happens to returning guests?
Returning guests are recognised automatically. MAC address and email matching means a returning guest either skips the portal entirely or is shown a personalised welcome-back message. Their visit history, frequency, and CRM data all update in real time.
Can I use this across multiple UniFi sites?
Yes. CaptiveWiFi is built for multi-site operators. Each venue gets its own portal, branding, and data set. Group-level reporting lets you see performance across all locations from a single dashboard.
Which UniFi API version does CaptiveWiFi use?
CaptiveWiFi is built on the latest Ubiquiti UniFi Network API (v2), using API key-based authentication via the UniFi Site Manager. This is Ubiquiti's current recommended integration method and replaces older cookie-based authentication approaches. It works with UniFi OS 3.x and above.
Does this work with UniFi Site Manager (ui.com)?
Yes. CaptiveWiFi supports both self-hosted UniFi Network Application and UniFi Site Manager via ui.com. The API key is generated in your Ubiquiti account under Site Manager, giving CaptiveWiFi secure, scoped access to authorise guest devices.
Other integrations

CaptiveWiFi connects to
your whole stack.