This guide walks you through connecting Interact with Kartra so quiz leads are automatically added as new contacts in your Kartra account.

You’ll be able to:

Send quiz leads to Kartra in real time
Choose which Kartra contact list new leads should be added to
Map quiz results and answers to Kartra actions (lists, fields, tags)
Use quiz data for segmentation, automation, and email campaigns

Before you start

Make sure you have the following:

An active Interact account
An active Kartra account
Access to Kartra API credentials
At least one created quiz in Interact

💡 Note: This feature is only available in the latest Interact user dashboard at app.tryinteract.com. Log in there to access it.

Step 1. Get your Kartra API credentials

Log in to your Kartra account.
Click Settings in the left-hand sidebar.
Select Integrations.
Click API.
Copy your API Key and API Password (you’ll paste both into Interact in the next step).

⚠️ Keep your API Key and API Password secure. Anyone with access to these credentials can add or update contacts in your Kartra account.

Step 2. Connect Kartra integration

Log in to Interact.
From your dashboard, go to Quizzes.
Click Edit to open quiz builder.
Go to Lead Generation > Integrations.
Find Kartra and click Connect.
Paste your Kartra API Key and Kartra API Password.
Click Connect.

You’ll see a confirmation once the connection is successful.

Step 3. Map quiz results to Kartra

When someone completes your quiz, Interact can take different actions in Kartra based on the quiz result they receive.

In the integration setup flow, go to the Results step.
You’ll see each quiz result listed separately.

For each quiz result, you can choose what happens in Kartra by adding actions.

Available actions for Kartra include:

Add to Contact List
Update Custom Field
Add tag to Contact

❗ Important: You must set Add to Contact List for every quiz result. If a result does not add the contact to a list, your other actions for that result may not run as expected.

Add to Contact List

When someone completes your quiz, Interact can add them to a Kartra list.

Click Add actions.
Find Add to Contact List.
Select the Kartra list from the dropdown you want quiz leads added to.

Update Custom Field

You can store the quiz result (or a custom value) on the Kartra contact record.

Click Add actions.
Find Update Custom Field.
Select the Kartra field from the dropdown you want to update.
Confirm the value being sent (this typically defaults to the quiz result title, but you can customize it if needed).

Add tag to Contact

You can apply a Kartra tag based on the quiz result.

Click Add actions.
Find Add tag to Contact.
Select the Kartra tag from the dropdown you want applied to contacts for this result.

Step 4. Map quiz answers to Kartra (optional)

In addition to quiz results, you can also send individual quiz answers to Kartra and use them for segmentation and automation.

This works the same way as mapping quiz results, but instead of triggering actions based on the final result, actions are triggered based on how someone answers a specific question.

💡 Tip: Quiz answers are great for capturing preferences, intent, or qualifiers (for example: budget, experience level, or goals).

Step 5. Map opt‑in form fields to Kartra

Next, connect your Interact opt‑in form fields to Kartra fields.

Go to the Fields step in the setup flow.
You’ll see Interact fields on the left and Kartra field mappings on the right.
Click the dropdown on the right of the form field you want to map (None Selected means it is not mapped).
Select the Kartra field you want to map to.

❗ Important: If your Kartra setup requires specific fields, make sure you map those required fields before sending a test lead

⚠️ Default fields (cannot be changed) include Email and First Name.

Step 6. Send a test lead

Before your integration is fully active, you’ll need to send a test lead.

This step verifies the connection between Interact and Kartra and activates the integration.

Click Send test lead.
Fill out all Opt-In Form fields to send as test lead information.
(Optional) Navigate to Quiz Data tab to customize test quiz data.
Click Send test lead to submit.
Log in to Kartra and verify the contact was created successfully.

Step 7. Publish your quiz

Any changes you make to your integration won’t be live until your quiz is published.

Before sharing your quiz:

Click Publish in the top-right corner of the quiz editor.
Confirm your changes by clicking Publish changes.

Once published, your Kartra integration will be active on the live version of your quiz.

⚠️ Remember: After making changes to your integration or opt-in form, publish all changes to update your live quiz.

Disable Kartra integration for your quiz

If you want to stop sending leads from a specific quiz to Kartra, you can disable the integration without disconnecting your Kartra account.

Edit the quiz in Interact.
Go to Lead Generation > Integrations.
Navigate to Connect step.
Click Disable.

⚠️ Remember: After making changes to your integration or opt-in form, publish all changes to update your live quiz.

Once disabled, new quiz submissions from this quiz will no longer be sent to Kartra. Your Kartra account remains connected and other quizzes are unaffected.

❗ Important: After disconnecting an integration from your quiz, your opt-in form will remain disabled until a new or existing integration is connected. Select .csv File Download to keep your opt-in form enabled with no integration connected.