Kartra Documentation TECHNICAL DOCUMENTATION

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. Note that before you can use the Zapier integration, some accounts might need to request activation. Upon request, our moderators will review within 24 hours.

Screenshot 20200826 050041 Chrome

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!

*Please 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“, which is effectively the specific command that initiates an action.

The configuration begins with you defining what the trigger will be for this particular Zap. For example: When a lead is subscribed to a certain list.

42

 

Kartra has a number of triggers you can work with:

  1. Lead Subscribes to List
  2. Lead is Assigned Tag
  3. Lead Fills an Optin Form
  4. Customer Buys Product
  5. Lead Is Granted Access to Membership

 

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

44

 

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 Tigger List

 

Next up, you need to hit Fetch & Continue.

Zapier Pull In Samples

 

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

Zapier Trigger Sample

 

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. Create New Lead
  2. Subscribe Lead to List
  3. Assign Tag to Lead
  4. Subscribe Lead to Sequence
  5. Edit Lead
  6. Retrieve Lead Details
  7. 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).

© 2020 Kartra All Rights Reserved