Kartra Documentation Technical Documentation for Kartra

Integrating Zapier and Kartra

As you start your Zapier integration with Kartra, you will want to make sure you are approved.  Proceed to the “my integrations” section of Kartra here: https://app.kartra.com/integrations and scroll down until you find the Zapier icon.

Before you can use the Zapier integration, some accounts might need to request activation. Upon request, our moderators will start the review within one business day. But please be mindful the review itself is not instant and may take a couple weeks at most to complete. As the time for a review is highly variable from one user to the next due to their account history and the use for which they require Zapier access.

Screenshot 20200826 050041 Chrome

*Note: Kartra support cannot speed up or escalate the review process. As support can merely provide advice to help in your review process, but not actually make a decision on it.

Once activated, and as opposed to most integrations in Kartra, the Zapier connection is not meant to be configured from within your Kartra account (except for the initial approval). Instead, everything happens from within your Zapier account, and Zapier will automatically establish the connection with Kartra in the background without you needing to do anything at all.

So, to get started, simply search for Kartra from within Zapier, and get those Zaps going!

*Note: the screenshots in this documentation may differ slightly from what you see in Zapier as they update their interface regularly, but the same logic should still apply.

Search for Kartra

Within Zapier you will choose the apps you wish to connect, just make sure one of your choices happens to be Kartra if you wish to integrate with our system.

Zapier Search

Once confirmed, we can start setting up your Zaps!

 

Setting Up Your Triggers

First things first: let’s discuss what Zapier calls the “trigger event“, which is effectively the specific command that initiates an action.

Zapier 1

The configuration begins with you defining what the trigger will be for this particular Zap. For example: When a lead opts in to a specific form.

Zapier 2

 

Kartra has a number of triggers you can work with:

  1. Lead is assigned tag
  2. Lead is unassigned tag
  3. Lead subscribes to list
  4. Lead is unsubscribed from list
  5. Lead fills opt-in form
  6. Lead is added to sequence
  7. Lead is removed from sequence
  8. Lead completes sequence
  9. Lead clicks on a tracking link
  10. Lead plays a Kartra video
  11. Lead completes a Kartra video
  12. Lead reaches score for the first time
  13. Affiliate signs up for product
  14. JV signs up for product
  15. Lead is granted access to membership
  16. Lead is revoked access to membership
  17. Customer buys product
  18. Customer refunds product
  19. Customer cancels subscription
  20. Lead registers a calendar
  21. Lead completes a calendar
  22. Lead cancels a calendar
  23. Lead visits a Kartra page
  24. Lead visits external page
  25. Lead clicks on page split test link
  26. Customer partial refunds product

After selecting your desired trigger rule, let’s proceed to connect with Kartra.

Zapier 3

 

You will be prompted to enter your Kartra API details from within your Kartra account.

45

 

Once the API connection with your Kartra account has been successfully established, Zapier will pull all the assets you’ve configured inside your Kartra account (all your Lists, all your Tags, all your Sequences, etc), and list them in the drop-down.

Zapier 5

 

Next up, you need to hit Continue.

Zapier 5a

 

You will notice that you can run a sample test to confirm that Zapier is properly pulling data from your Kartra account.

Zapier 6

 

Setting Up Your Actions

An “action” is a trigger’s outcome, meaning the event you actually want the system to perform when a trigger rule takes place.

So, the first step would be to select the Kartra App and to define your desired action. For example: Assign a Tag to a Lead.

46

 

Kartra has a number of actions you can work with, and Zapier will prompt you to choose which one you want to add to this particular Zap:

  1. Retrieve all the tags in your account
  2. Retrieve all the lists in your account
  3. Unassign tag from lead
  4. Subscribe lead to list
  5. Unsubscribe lead from list
  6. Add points to lead
  7. Remove points from lead
  8. Subscribe lead to sequence
  9. Unsubscribe lead from sequence
  10. Retrieve all the sequences in your account
  11. Retrieve all the pages in your account
  12. Assign tag to lead
  13. Refund a transaction
  14. Cancel a subscription
  15. Subscribe lead to calendar
  16. Cancel lead subscription to calendar
  17. Create new lead
  18. Edit lead
  19. Retrieve all the custom fields in your account
  20. Create custom field
  21. Retrieve lead details
  22. ​Search lead

Once the type of action is selected, and just like before, the system will ask you to connect your Kartra account’s API keys. However, since you’ve already entered them while setting up your triggers, you can simply pre-select the same connection – no need to configure a new connection all over again.

Anyway, now that the connection for this action is established, you may continue configuring the action for this Zap.

*Please note, you will always need to “create new lead” for any lead that is not already within the Kartra system; this essentially makes the “create new lead” your first action in most scenarios.

Managing Your Leads

Here’s an important thing to remember: In order to perform an action upon a lead, the lead must already exist in your Kartra’s lead database. Otherwise, the system will prompt a “No lead found” error. That means that if you want to execute an action for a brand new user, you will need to use first the “Create New Lead” action, and then follow up with your originally intended action.

Moreover, if you’d like to verify whether a lead is indeed part of your Kartra’s contacts database, you may use the “Search Lead” function by querying his/her email address.

Zapier Lead Search

 

In return, Kartra will ping back either a “Lead found” or “No lead found” message:

Zapier Lead Exists

 

As explained above, if the lead does not exist, you will want to create it by using the “Create New Lead” action. Here, you will need to pass the lead’s email (the only mandatory field), plus whatever other optional fields such as first name, last name, etc.

Zapier Create Lead

And the system should respond back with a success message:

Zapier Create Lead Id

 

By the way, remember that for any existing lead in your database, you can always use the Retrieve Lead Details query to import all the lead’s standard fields (first name, address, country, etc), as well as any custom field you might have created. In fact, you could chain this query to any previous trigger:

34

 

Anyway, now that you know how to register a lead in your Kartra database and how to retrieve his/her profile details, you can go ahead and perform whatever other actions you wish upon the lead.

All you would need to do is to use the appropriate instruction (Subscribe Lead To List, Assign Tag, etc.) along with the lead’s email address:

Zapier Add List

 

Here’s an advanced configuration worth playing with:

If, upon executing an action, you do get the “No lead found” message, you could use Zapier’s built-in Filter App to implement the following chain of events: IF message received is “No lead found“, THEN “Create New Lead” followed by *insert any other action here*.

Zapier Filter App

 

See the screenshot below: while setting up your Filter, choose “Only Continue If…” and then “Message” being “No lead found“:

Zapier Lead Not Found

 

Remember that you can chain as many Steps into your Zap as you need:

47

 

You’re done! Simply name your Zap and it’s good to go. Congratulations!

Zapier Finish

GDPR with leads brought in by Zapier

As you may already be aware, Kartra does support the option to manage your GDPR compliance.  To that end we would like to clarify that when you use Zapier to send lead data back to Kartra, the information is transmitted via an API call, like a sky-walk between two separate corporate buildings. Because these two systems have separate databases, security protocols, and connect only via API, we are unable to pass the GDPR authorization between them.

The only way to ensure a lead is cleared for GDPR in Kartra is to collect the information through one of our opt-in or checkout forms on a Kartra page. GDPR clearance will be verified at the time of opt-in, and the lead will be clear to email.

Be mindful this also includes non-European residences as anyone without a verified IP through our content (opt-in or checkout form) will be marked as “unknown” and will be affected by GDPR restrictions.  Regardless of what address they may have provided, we have to assume they are in Europe with GDPR options enabled until they actually go through a Kartra based opt-in form or product checkout to prove an alternative residence. So as an example, a USA resident can have their lead taken from an external system and put into a Kartra account via Zapier. But then that lead will be blocked by GDPR despite being from the USA until that lead fills out an opt-in or product checkout form in Kartra (Assuming GDPR is enabled on the Kartra account).

© 2024 Kartra All Rights Reserved