Skip to content

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.

Integrations and Settings pinned at the bottom of the CaptiFi dashboard 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.

CaptiFi Integrations page Klaviyo card showing Not connected, the Configure button and the Setup guide button

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.

CaptiFi Klaviyo panel for the venue The Copper Still, reading Not connected, with the Connect with Klaviyo box and its Connect with Klaviyo button

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.

Klaviyo screen headed App has not been reviewed, with the CaptiFi logo, Klaviyo's warning text and the Exit and Continue buttons

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.

Klaviyo screen headed Allow CaptiFi to access your account's information, listing Accounts, List, Profiles and Subscriptions access, with the Allow and Deny buttons

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.

CaptiFi Klaviyo panel after connecting: The Copper Still reads Connected and active with the toggle on Enabled, the box says it is connected to Captifi LTD through the Klaviyo sign-in, and there is a green Klaviyo connected message and a Disconnect Klaviyo button

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).

Klaviyo Lists and segments with a list open, ready to read its ID

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.

Klaviyo List details panel showing the list ID and name

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.

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.

Klaviyo list consent settings with the single and double opt-in options

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 ​

DataNotes
Email, first and last nameOnly guests who accept marketing
Phone numberOnly if your splash page collects it
WiFi propertiesVenue and source, written onto the profile
Custom profile propertiesAny key/value pairs you define, on every synced profile
List subscriptionOnly when a List ID is set, with explicit consent
Date of birthOnly when Age-gated Klaviyo account is on, from the splash page Date of Birth field
Connected to WiFi eventOne 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:

PropertyExampleMeaning
venue_nameThe Copper StillThe venue the guest connected at
site_id17051The venue's CaptiFi ID
visit_number3How many times this guest has connected at the venue, this visit included
first_visitfalsetrue 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.

  1. In the CaptiFi Klaviyo panel, switch on Age-gated Klaviyo account
  2. In the Splash Page Builder, add a Date of Birth field to your sign-in form and set it to required
  3. 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:

KeyValue
local_venueBurswood Beerhall (WA)
signup_channelvenue_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.

Klaviyo Settings API keys page showing the Private API Keys panel and the Create Private API Key button

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.

Klaviyo create private API key screen with the key name field and the Full Access Key access level selected

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.

CaptiFi Klaviyo configuration panel with the Private API Key and List ID fields empty

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.

CaptiFi Klaviyo configuration panel with the private API key entered and a List ID filled in

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.

CaptiFi Klaviyo panel after saving, showing Secret saved and the Settings saved confirmation

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.

CaptiFi Klaviyo integration enabled for the venue

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.

CaptiFi Integrations page Klaviyo card showing Connected, Active on 1 of 1 connected venue, and the Manage and Setup guide buttons

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.

CaptiFi: Guest WiFi Marketing Platform