Klaviyo’s automated marketing tools let you segment your audience, schedule email messages, and keep track of how your clients are feeling. With this integration, your Typeform responses can create and update contacts in Klaviyo in real time.
In this article, we’ll walk you through how to link your form to Klaviyo and map Typeform responses, Variables, URL parameters, Scores, and Enrichment variables to Klaviyo’s properties all within the Connect panel of your Typeform account. This integration is available on all Typeform plans.
Want to send your forms from a Klaviyo email instead? Take a look at our article on how to launch a form from a Klaviyo email.
Create or update Klaviyo profiles with partial responses
If you've added a Partial Submit Point(s) to your form, a new profile will be created or updated each time a respondent passes a Partial Submit Point.
You can enable Partial responses for Klaviyo in your form's settings:
1. Click the settings icon in the tool bar of the Content panel.
2. Under Preferences, toggle on Send partial responses to integrations and click Save.
Then follow the instructions below to set up the integration.
How to set up the integration
1. Create a form that collects contact information, like name and email. To use this integration, you must have an Email question.
Additionally, we recommend adding a Yes/No or Legal question to ask respondents for consent on if they would like to opt in or out of receiving emails from you.
Make sure your form is published after you’ve created it.
2. Click the Connect tab.
3. Next, scroll through the list of integrations or use the search bar to locate the Klaviyo integration. Click Connect.
4. To authenticate your Klaviyo account, click Add Account.
A pop up will appear asking if you want to allow account access. Click Allow.
Then click Continue.
5. Select which Klaviyo list you want to update from the dropdown. Then click Continue.
6. Now you can start mapping your form questions. You can send data to specific custom properties in Klaviyo by clicking Add custom field. You can also map Typeform Variables, URL parameters, Scores, Enrichment variables, and Outcome quiz results (winning_outcome_id) to Klaviyo properties (see Mapping FAQ section for more information).
Remember that you must map your Email question to Klaviyo before you can continue to the next step.
Click Continue when you're done mapping.
7. Next, you’ll select a question for recording consent.
In the dropdown, select the question in your form that asks respondents to opt in to receiving emails. If respondents opt out, you have the option to not create new contacts or create contacts with an ‘unsubscribed’ status in Klaviyo. Click Finish when done.
If you did not add a consent question to your form, click Finish to complete the integration set up.
If you've added a consent question to your form, asking if respondents would like to opt in or out of receiving emails, you have the option to select from the following:
| If you select: | Answer respondent chooses: | What happens in Klaviyo profile: |
| Don't create new contacts (or unsubscribe existing ones) | Yes | Create or update profile as "subscribed" |
| No | Does not create or update profile | |
| Create contacts with "unsubscribed" status in Klaviyo | Yes | Create or update profile as "subscribed" |
| No | Create profile as "never_subscribed" Does not update existing profile |
If you do not have a consent question in your form, the following will happen to Klaviyo profiles:
| Respondent's Klaviyo profile: | What happens in Klaviyo profile: |
| New profile | Create new profile as "never_subscribed" |
| Existing profile | Does not update the subscription state of the profile |
8. Now when respondents submit their answers to your form, a new contact will be created or the existing contact will be updated in Klaviyo.
Additionally, a Filled Out Form event will appear in the contact's profile when a respondent submits a form.
If you need to edit the integration, head back to the Connect panel in your Typeform account and click the three dots next to the Klaviyo integration. Then select Edit.
Mapping FAQs
Can I map the Matrix question type?
No, unfortunately, the Matrix question type isn't compatible with this integration.
Can I map the File Upload question type?
Yes. When you map the File Upload question type, a URL to download the file will be sent to Klaviyo.
We recommend mapping the File Upload question to a custom field/property in Klaviyo and the URL to download the file will appear under Custom properties in the Klaviyo profile.
If you map the File Upload question to Klaviyo's Image URL field, you can only retrieve the URL to download the file through Klaviyo's API.
Can I map an address?
Yes, you can map an address to Klaviyo's address fields: Address1, Address2, Region, Country, and Zip Code. Klaviyo's Region field is used for State, Region, or Province. All address fields will appear under Klaviyo's Location section.
You don't need to map the full address to Klaviyo. If you only map to one of the address fields, it'll still appear under Klaviyo's Location section.
What can I map to Klaviyo's Locale field?
Klaviyo's Locale field is designed to store language and region codes for multilingual messaging. It should not be used to store location/address information.
Data mapped to Klaviyo's Locale field needs to be formatted as a language and region code, such as:
- en-US
- fr-FR
How do I map to a Klaviyo custom field?
You can create a new custom field in Klaviyo and map a form question to it by clicking Add custom field during the mapping set up.
Custom fields you've previously created in Klaviyo won't appear in the Typeform drop downs when mapping. To map to a custom field, scroll down to the bottom of the default fields and click Add custom field.
Then enter the name of your custom field exactly as it is in Klaviyo. Click Continue when you're done mapping.
What are the default Klaviyo fields that I can map to?
- Email (required)
- First Name
- Last Name
- Phone Number
- Title
- Organization
- City
- Country
- Zip Code
- Address1
- Address2
- External ID
- Region
- Locale
- Image URL
- Add custom field
FAQs
Can I add multiple profiles to Klaviyo from the same form?
You can't create multiple Klaviyo profiles from the same form. You can only map one email question to a Klaviyo email field, which creates or updates a Klaviyo profile. If you need multiple Klaviyo profiles created for multiple contacts, the form will need to be filled out by each contact individually.
However, if you create a secondary email field in Klaviyo, you can map a secondary email address to this field. Keep in mind that this secondary email will not create a new profile. It'll be included in the profile of the person who submitted the form. For example, if you created a secondary email field in Klaviyo called Alternative email, you can map a secondary email question to this field. The Alternative email field will be under the first email's Klaviyo profile.
Can I connect different Klaviyo accounts to different forms?
Yes. You can connect different Klaviyo accounts to different forms. Each form can be authenticated with its own Klaviyo account, so it's possible to have one Klaviyo account connected to Form A and a different Klaviyo account connected to Form B.
I just created a new List in Klaviyo, but it doesn't appear in the dropdown
The dropdown of available Lists doesn't update live. You'll need to create the Klaviyo list before setting up the integration. If you've just created a List after you've tried to connect to Klaviyo, exit the intergration setup, refresh the Connect panel, then re-connect to Klaviyo to see the most recent Klaviyo Lists.
Why aren't my respondents getting an opt-in email from Klaviyo?
If the respondent agrees to the opt-in question in your form and you've configured the privacy consent in the integration set up, the following behavior will depend on the settings you have set up in your Klaviyo list.
- If you have single opt-in set up in your Klaviyo list: When the respondent agrees to opt-in, this will subscribe the respondent and they will not receive an opt-in email from Klaviyo.
- If you have double opt-in set up in your Klaviyo list: When the respondent agrees to opt-in, the respondent will receive an email from Klaviyo asking them to confirm. Learn more about Klaviyo's double opt-in from their Help Center article here.