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 gets | Survey events as metrics on the profile |
| Events | Survey shown, started, submitted, partially submitted and dismissed |
| Anonymous respondents | Supported, with Include anonymous respondents on |
| User profile | Updated with the user's traits when Update the user's profile is on |
| Status | Available |
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
- In Klaviyo, click your account name (bottom left) and open Settings → API keys.
- Click Create Private API Key and give it a name you'll recognise, for example
Encatch. - Choose a custom key and set Events to Full Access. No other scope is needed.
- Click Create and copy the key.
Step 2: Add the connection in Encatch
- In Encatch, open Data sync → Survey events and click Add connection.
- Choose Klaviyo.
- Enter a Name you'll recognise in the list and in Logs.
- Fill in the Klaviyo settings:
| Field | What to enter |
|---|---|
| Private API key | The Private API key you created. |
- 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
- Under Surveys, choose All surveys or Only these surveys.
- 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.
- Rename an event if you want another name in Klaviyo. The defaults are
encatch_survey_shown,encatch_survey_started,encatch_survey_submitted,encatch_survey_partialandencatch_survey_dismissed. - To also send responses of people who are not signed in, turn on Include anonymous respondents.
- 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 see | What it means | What to do |
|---|---|---|
| Key refused | The key was deleted or mistyped | Create a new Private API key and paste it with Replace |
| Refused by the tool | The key has no write access to Events | Create a key with Events set to Full Access |
Was this page helpful?
