Welcome to Encatch Docs
Data syncBetaConnectorsEngagement and marketing

Klaviyo

Send Encatch survey events to Klaviyo - where to find the details in Klaviyo and how to set up the connection

Overview

The Klaviyo connector sends survey events to Klaviyo as metrics on the profile, so a survey answer can trigger a flow or define a segment.

What it getsSurvey events as metrics on the profile
EventsSurvey shown, started, submitted, partially submitted and dismissed
Anonymous respondentsSupported, with Include anonymous respondents on
User profileUpdated with the user's traits when Update the user's profile is on
StatusAvailable

What You'll Need

Before you start, make sure you have:

  • A Klaviyo account — with permission to create API keys
  • A Private API key — with Events set to Full Access (Step 1)

Step 1: Create a Private API key in Klaviyo

  1. In Klaviyo, click your account name (bottom left) and open Settings → API keys.
  2. Click Create Private API Key and give it a name you'll recognise, for example Encatch.
  3. Choose a custom key and set Events to Full Access. No other scope is needed.
  4. Click Create and copy the key.

Step 2: Add the connection in Encatch

  1. In Encatch, open Data sync → Survey events and click Add connection.
  2. Choose Klaviyo.
  3. Enter a Name you'll recognise in the list and in Logs.
  4. Fill in the Klaviyo settings:
FieldWhat to enter
Private API keyThe Private API key you created.
  1. Press Test connection. Encatch shows what Klaviyo answered.

Encatch keeps the keys encrypted and never shows them again. To change one later, press Replace.


Step 3: Choose what to send

  1. Under Surveys, choose All surveys or Only these surveys.
  2. Under What is sent, tick the events to send. A new connection starts with Survey shown, started, submitted and dismissed ticked. Survey partially submitted is off until you tick it.
  3. Rename an event if you want another name in Klaviyo. The defaults are encatch_survey_shown, encatch_survey_started, encatch_survey_submitted, encatch_survey_partial and encatch_survey_dismissed.
  4. To also send responses of people who are not signed in, turn on Include anonymous respondents.
  5. Open Advanced options to choose how users are identified, whether answers are sent and the rate limit.

Every option is explained in Connection settings.


Step 4: Save and start sending

Click Save. Saving does not start sending: press Start sending when you are ready. From then on events go out as they happen, and every delivery is listed in Logs.


Check it in Klaviyo

Test connection creates a metric named encatch_test_event. In Klaviyo, open Analytics → Metrics: each survey event appears as a metric under the name you chose. The profile shows the event in its activity, with the External ID set to the user's identifier.


Good to know

  • One profile per person. With Also send the email on, the user's email is sent next to the identifier so Klaviyo keeps one profile.
  • Profile update. With Update the user's profile on, the user's Encatch traits are set as custom properties on the profile.
  • Anonymous respondents arrive as a profile with an ID only.
  • Rate limit. A new connection starts at 1,500 events a minute. Klaviyo takes 3,500 events a minute per account, shared by every private key.
  • Also send the email. Klaviyo keeps the email in its own field next to the user ID. Turn the option on in Advanced options to send it.

Troubleshooting

What you seeWhat it meansWhat to do
Key refusedThe key was deleted or mistypedCreate a new Private API key and paste it with Replace
Refused by the toolThe key has no write access to EventsCreate a key with Events set to Full Access

Was this page helpful?