With our Klaviyo integration, Grapevine will send details of new survey responses which can be used to create workflows and automations. This article will detail the various survey events that are sent.

The Klaviyo integration will need to be enabled. Please see the following article for details on how to set that up: How to enable the Klaviyo integration

As long as there is an email associated with a survey response, we can push survey events into Klaviyo.

Events will be pushed into an existing Klaviyo profile associated with that email address, or if no profile exists, then a new profile will be created in Klaviyo.

There are currently three types of survey events we send to Klaviyo:

The events and their parameters are detailed below:

The survey response event is sent when a survey's Next or Submit button is first clicked.

Only one instance of this event will be sent even in the case of multiple questions being answered. It is, essentially, a 'Survey started' event:

Survey Type: All surveys created after January 10th 2024 will be of type multi_question, even if they have just a single question. Surveys created before this date will have used an old architecture and will be single question surveys with their survey type being Fixed Response, NPS, or Open Text.

Survey Code: This is a survey's unique identifier. It can be used within Klaviyo Flows as a trigger and as a filter. Please read our article on how to find the unique survey code.
​

External Id: A URL parameter ?external_id=something can be included within an on-site survey URL. It is useful if you would like to use an identifier from another system such as a profile id from a CRM system.

The survey response question answered event is sent when either a Next button on a post-purchase survey is clicked, or, the Submit button of an on-site survey has been clicked:

Question Code: Each survey question has a unique identifier. It can be used within Klaviyo Flows as a trigger and as a filter. Please read our article on how to find a unique question code.

Answer: If an un-required question goes unanswered, it will still trigger a survey response question answered event. However, the Answer value will be null:

Is Other: A value of Yes will signify that the Global Other option has been used for the response:

Score: The response score from an NPS survey question:

Cohort: A value of promoter, passive or detractor based on the NPS response score. A very useful metric when used to create Flows and Segments within Klaviyo:

The survey response completed event is sent when a survey's final Submit button has been clicked. If the survey includes non-required questions that go unanswered, this event is still sent as the respondent has followed the survey through until the end:

When a survey has more than one question, events may come through to Klaviyo between 1 and 5 minutes apart. This short delay prevents events being overwritten by each other when delivered to Klaviyo with the same timestamp.

Please see our article below for guidance on how to use these events within your Klaviyo flows:

Using a survey response as a Klaviyo Flow trigger

If you have any questions about the content of this article or any other Grapevine Surveys related question, then please do just get in touch.