Appearance
How to set up the Klaviyo integration with CaptiFi
Follow the steps below and every WiFi guest who accepts marketing at your venue will be created or updated as a Klaviyo profile, and can be subscribed to one of your Klaviyo lists.
You connect by signing in to Klaviyo and approving CaptiFi, so there is no API key to create or paste. If you would rather manage the access yourself, a Klaviyo private API key still works: see Use a private API key instead.
Time needed: under 10 minutes, including the optional list and the test at the end.
What this integration does
When a guest connects to your WiFi and accepts marketing, CaptiFi creates or updates their Klaviyo profile (email, name, phone when you collect it) with WiFi properties for the venue and source. If you also set a List ID, the guest is subscribed to that list with explicit consent, so your Klaviyo welcome flow can fire straight away.
Before you start
- A Klaviyo login with the Owner, Admin or Manager role. Klaviyo only lets those roles install apps such as CaptiFi. (The private API key route needs an Owner or Admin.)
- A CaptiFi plan that includes integrations (Growth or above; a 30-day trial started on Growth or above includes them)
- On a team login, permission to manage integrations and to view guests
- Your venue live in CaptiFi with a splash page that collects an email address
Part 1: Connect with Klaviyo
Step 1: Open the Integrations page
Log in to my.captifi.io and click Integrations at the bottom of the left sidebar.

Step 2: Find the Klaviyo card and click Configure
Scroll to the Klaviyo card. It shows Not connected until you finish setup. Click Configure, and a panel opens with one section per venue you manage.

Step 3: Click Connect with Klaviyo
Each venue has a Connect with Klaviyo box above its Private API Key field. Click Connect with Klaviyo on the venue you want to connect, and CaptiFi takes you to Klaviyo.

Step 4: Sign in to Klaviyo and click Continue
Sign in to Klaviyo if it asks you to. Next comes a screen headed App has not been reviewed, which Klaviyo puts up until its partner team has reviewed the CaptiFi app. Click Continue.

If your login can use more than one Klaviyo account, Klaviyo may ask which one. Choose the account this venue's guests should go to.
Step 5: Click Allow
Klaviyo lists the access CaptiFi is asking for:
- Accounts: view account details
- List: create, edit and delete lists and list memberships
- Profiles: create, edit and delete profiles
- Subscriptions: create, edit and delete consent and subscription preferences
CaptiFi uses this to read your account name, create and update guest profiles, and subscribe guests to your list with their consent. Click Allow.

Step 6: Check the venue is connected
Klaviyo sends you back to the Klaviyo card in CaptiFi, where a green Klaviyo connected message tells you new guest sign-ups will sync to your Klaviyo account. The venue reads Connected and active with its toggle already on Enabled, and the box names the Klaviyo account it is connected to. The sync runs from here, and you can leave Private API Key empty.

Each venue connects on its own, so repeat Steps 3 to 5 for any other venue you want in Klaviyo.
Connecting is not retrospective
Only guests who connect to your WiFi from now on are sent to Klaviyo. Guests who signed in earlier are not copied across.
Part 2: Optional, add your Klaviyo List ID
Skip this part if you only want profiles created. Set a List ID if you want guests subscribed to a specific list so your flows and campaigns can use them.
Step 7: Open the list you want guests to join
In Klaviyo go to Lists & segments and click the list (create one first if you need to, for example WiFi Guests).

Step 8: Copy the List ID from List details
Open the Settings tab, then List details. The ID is the short code shown there, for example RX2AR.

Step 9: Paste the List ID into CaptiFi and click Save
Back on the Klaviyo card in CaptiFi, paste the code into the venue's List ID field and click Save. You can leave Private API Key empty, because the venue is already connected through your Klaviyo sign-in.
To check the connection, click Test connection. It answers Connected to followed by your Klaviyo account name.
Part 3: Set your consent preference in Klaviyo
Step 10: Choose single or double opt-in on the list
Open your list in Klaviyo, go to Settings, then Consent. Double opt-in means Klaviyo emails each guest a confirmation link and only subscribes them when they click it.

Which to pick:
- Double opt-in is the safest choice for compliance and list quality, and is required by some regulators and by Klaviyo for certain senders. Guests must open the confirmation email, so expect fewer subscribers than sign-ins.
- Single opt-in subscribes the guest immediately. Your welcome flow fires while they are still in the venue, which is usually what venues want. CaptiFi has already captured explicit marketing consent on the splash page before sending anything.
Part 4: Test it end to end
Step 11: Sign in as a guest
On a phone, forget the WiFi network, reconnect, and complete your splash page with a real email you can check. Accept marketing when the splash page asks.
Step 12: Check the profile in Klaviyo
In Klaviyo, search Profiles for that email. Within a few minutes you should see the profile with your venue and source properties, and if you set a List ID, membership of that list. On a double opt-in list the guest joins once they click the link in Klaviyo's confirmation email.
What gets synced
| Data | Notes |
|---|---|
| Email, first and last name | Only guests who accept marketing |
| Phone number | Only if your splash page collects it |
| WiFi properties | Venue and source, written onto the profile |
| Custom profile properties | Any key/value pairs you define, on every synced profile |
| List subscription | Only when a List ID is set, with explicit consent |
| Date of birth | Only when Age-gated Klaviyo account is on, from the splash page Date of Birth field |
| Connected to WiFi event | One per visit, for venues connected with Connect with Klaviyo |
Connected to WiFi visits
When a venue is connected with Connect with Klaviyo, each visit by a guest who accepts marketing is also recorded in Klaviyo as a Connected to WiFi event on their profile. It appears in Klaviyo under Analytics > Metrics with the CaptiFi logo once the first guest has connected.
Each event carries these properties:
| Property | Example | Meaning |
|---|---|---|
venue_name | The Copper Still | The venue the guest connected at |
site_id | 17051 | The venue's CaptiFi ID |
visit_number | 3 | How many times this guest has connected at the venue, this visit included |
first_visit | false | true on a guest's first visit to the venue |
Use the metric as a flow trigger in Klaviyo. A flow triggered by Connected to WiFi with the filter first_visit equals false sends a welcome back message to returning guests, and visit_number equals 5 can reward a regular. Signing in again within 30 minutes counts as the same visit, so a guest who reconnects does not trigger a flow twice.
Venues connected with a private API key get profiles and list subscriptions as before, but no Connected to WiFi events. CaptiFi sends these events only through the app connection, which is what lets Klaviyo show them as CaptiFi's.
Age-gated Klaviyo accounts (alcohol brands)
Some Klaviyo accounts are age-gated: alcohol brands and other age-restricted businesses must supply a date of birth with every list subscription.
- In the CaptiFi Klaviyo panel, switch on Age-gated Klaviyo account
- In the Splash Page Builder, add a Date of Birth field to your sign-in form and set it to required
- Set the field's minimum age to 18, or the legal age where you operate, so under-age guests cannot submit the form at all
Every list subscription then includes the guest's date of birth as age_gated_date_of_birth. Guests who connect without a date of birth are still created as profiles, but are not subscribed to the list, so an age-gated list never receives a subscriber without one.
Custom profile properties
You can define up to 20 static key/value pairs that CaptiFi writes verbatim onto every profile it syncs. Use them to tag WiFi sign-ups for your segments and flows:
| Key | Value |
|---|---|
local_venue | Burswood Beerhall (WA) |
signup_channel | venue_wifi |
Add them under Custom profile properties in the same panel, then click Save.
Use a private API key instead
Use this if you would rather create the access in Klaviyo yourself. A venue you connected in Part 1 does not need a key. You need the Owner or Admin role in Klaviyo to create one.
Step 1: Open your Klaviyo API keys page
Log in to Klaviyo, click your organisation name in the bottom left, choose Settings, then click API keys.

Step 2: Click Create Private API Key
The button sits at the top right of the Private API Keys panel.
Step 3: Name the key and give it Full Access
Type a name you will recognise later, for example CaptiFi WiFi, then select Full Access Key.

Full Access is required
CaptiFi needs to write profiles, lists and subscriptions. A Read-Only key will fail the connection test.
Step 4: Click Create, then copy the key
Klaviyo shows the key once only. Copy it now and keep it somewhere safe (a password manager, not a notepad on the bar). It starts with pk_.
Step 5: Paste the key into CaptiFi
Open the Klaviyo card in CaptiFi (Steps 1 and 2 of Part 1) and paste the key into the venue's Private API Key field. The field is write-only: once saved, CaptiFi never shows it again.

If you want guests subscribed to a list, paste your List ID (Part 2) into List ID as well. Leave it blank to create profiles only.

Step 6: Click Save, then Test connection
Save stores the credentials. Test connection calls Klaviyo with them and tells you straight away if the key is wrong.

Step 7: Switch the venue on
The venue reads Connected but paused until you flip the toggle to Enabled. Nothing syncs while it is paused, and once it is on, only guests who connect from then on are sent.

Step 8: Confirm the card says Connected
Close the panel. The Klaviyo card now shows Connected, tells you how many venues are active, and the button changes to Manage.

Now test it end to end.
Disconnecting
To stop a venue connected with Connect with Klaviyo, click Disconnect Klaviyo in its Connect with Klaviyo box, then press and hold the button to confirm. This removes CaptiFi from the Klaviyo account and stops the sync at that venue, unless a private API key is also saved for it.
For a venue that uses a private API key, click Disconnect at the bottom of the venue's section to clear the saved key.
To pause a venue for a while and keep its connection, switch its toggle to Disabled instead.
Troubleshooting
There is no Connect with Klaviyo button: your team role may not include managing integrations. Ask the account owner to connect Klaviyo for you, or to give you that permission.
You cannot approve CaptiFi in Klaviyo: Klaviyo only lets the Owner, Admin and Manager roles install apps. Ask an Owner or Admin in your Klaviyo account to give you one of those roles, then try again.
"Klaviyo was not connected because the permissions were not approved": the request was turned down in Klaviyo, for example with Deny. Click Connect with Klaviyo again and click Allow when Klaviyo asks.
"That Klaviyo sign-in is no longer valid": click Connect with Klaviyo again to start a fresh sign-in.
Test connection returns HTTP 401 with a private API key: the key is wrong, was revoked, or is Read-Only. Create a new Full Access private key in Klaviyo and paste it again.
Profiles appear but the list stays empty: no List ID is set, or the ID is wrong. Re-copy it from List details (Step 8) and click Save.
Nothing at all appears: check the venue reads Connected and active with its toggle on Enabled, and that the guest accepted marketing. Guests who decline marketing are never sent to Klaviyo.
The list is age-gated and subscribers are rejected: switch on Age-gated Klaviyo account and add a required Date of Birth field to your splash page.
Guests get a confirmation email they never click: your list is set to double opt-in. Switch to single opt-in in Settings, Consent if you would rather subscribe them immediately.