SamCart's Integration Engine is here to help you connect SamCart to each of your favorite tools + automate everything from cart abandonment to delivering your products. 

The Integration Engine allows you to create custom If/Then rules that help you automate every step of your customer's journey. These rules are based off of Trigger Events that happen inside of SamCart. So you can create your own rule when a contact runs into any of these Trigger Events...

  • Product Purchased
  • Product Refunded
  • Prospect Created (i.e. Cart Abandonment)
  • Subscription Canceled
  • Subscription Delinquent
  • Subscription Recovered
  • Subscription Restarted
  • Subscription Charged
  • Subscription Charge Failed
  • Order Completed
  • Upsell Purchased

Below, we'll break down how it works and some features that make running your business easier than ever!

Integrate You Application With SamCart

Start by clicking over to your Marketplace Settings. Then select Integrations from the left-hand side of your screen.

Here, under the Integration Setup tab, you'll see a list of all your active integrations that are already connected to SamCart's Integration Engine

To add a new new integration, click the New Integration button: 

In the popup window, select the application to integrate (1), and then click Next Step (2). In this example, we'll be integrating MailChimp, a popular email marketing application.

Next, SamCart will ask you to name the integration. This is just an internal label, so you can tell one integration from another. Super useful if you ever need to connect multiple accounts of the same application! Common names go something like, "Melissa's MailChimp", "Personal MailChimp", etc.

Give your integration a name and click Connect with OAuth

NOTE: For select applications, OAuth may not be available. In this case, there may be  additional steps required before integration can be completed. 

Next, you will be prompted to enter your login details for that application. After you submit your login details, you'll see a screen confirming that the integration was successful.

Click the Click Here link, and you'll be taken right back to SamCart's Integration Engine. Once the application is successfully integrated, it will appear in the Integration Setup tab. 

Now we're ready to create some Integration Rules! Below, we'll go over the two types of Integration Rules in SamCart. 

Creating Integration Rules at the Product Level: 

Now that SamCart is "connected" to your application, you'll need to establish simple rules that tell the Integration Engine what to do when certain actions takes place in your SamCart Marketplace. 

Head over to your Product and click into the Integrations tab (1), then click New Rule (2)

First, you'll need to select a trigger. A trigger is the event inside of your SamCart Marketplace that tells the Integration Engine it's time to make something happen in a connected application. In this example, we'll use the Product Purchased trigger as it's the most common. 

Select Product Purchased from the drop-down menu and click Next Step:

In the following window, we'll establish the specific action we want the rule to perform. First, select the desired Integration (1) in the first drop-down menu. Your integrations will be sorted using the internal label you chose when you connected the application. 

Next, choose an Action (2) you'd like the integration to perform. In this example, we're choosing Add To List, which will add all new customers for this Product to an Email List in MailChimp. When you're done, click Next Step (3).

NOTE: Each application has different Actions available. 

Lastly, we need to choose where the Integration Engine will point your new customers. For this example, we're going to place all of our new customers for this Product in the 'Test MailChimp 1" Email List, which was created in MailChimp. 

Choose the destination from the drop-down menu and click Submit:

And we're done! Now, anyone who purchases this Product will be added to the "Test MailChimp 1" list in MailChimp. 

In this example, we created Product-Level Integration Rules using the Product Purchased action, but you can also create rules for the following actions: 

  • Product Purchased
  • Product Refunded
  • Subscription Canceled
  • Subscription Delinquent
  • Subscription Recovered
  • Subscription Recovered
  • Subscription Restarted
  • Subscription Charged
  • Subscription Charge Failed
  • Order Completed
  • Upsell Purchased

Creating Global Integration Rules

Global Rules aren't too different from Product-Level Integration Rules, except for the fact that they're triggered by every Product in your Marketplace. For example, if you'd like every new customer, regardless of the Product they purchased, to be added to a specific Email List, you'd create a Global Rule

To create a Global Rule in SamCart, head back to your Marketplace's Integration Settings

Here, click on the Global Rules tab (1) and select New Rule (2):

Once you've done that, the steps to creating a Global Rule are identical to that of a Product-Level Integration Rule. Reference the "Creating Integration Rules at the Product Level:" section above for a detailed breakdown on how to proceed. 

After your Global Rule is created, it will appear under the Global Rules tab: 

FAQ: 

Q: How do I access the Integration Engine if I'm using the "old" system?

A: Head to your Marketplace Settings > Integrations and click the Click Here link in the blue bar at the top of your screen:

Q: I've set up my integration correctly but nothing is showing up in my application after running a Sandbox Mode/test order.

A: Check the email address you used in your Sandbox Mode/test order. If you used the same email address as the administrative email address in the application you're integrated with, it's likely the order won't show up. Try again using a different email address.

Q: My integration seems to be functioning properly, but a customer wasn't added to the correct List/Group/Level/Tag/Offer seemingly at random. What happened? 

A: If an integration rule fails to fire, there's always a reason. The Integration Engine keeps a record of the last 1,000 integration events that took place in your Marketplace, and they can be viewed by heading to Marketplace Settings > Integrations > Logs

Here, you can search for the event in question and check if anything went wrong. 99% of the time the Logs can provide insight into exactly what might've went wrong with that action. 

Q: The List/Group/Level/Tag/Offer I'm looking for isn't showing up when I try to create an integration rule. What should I do? 

A: If you don't see what you're looking for when creating a rule hit the Refresh button before looking again:

If you created the List/Group/Level/Tag/Offer after you set up the integrtion with SamCart for the first time, there's a good chance you'll need to Refresh the list in order for it to fetch your current settings.  

Also, if you have a long list of Tags, you may need to begin typing the Tag you're looking for in order for it to appear. It should auto-fill the Tag once the Integration Engine recognizes it. 

Q: How can I delete, re-name, or refresh my integration if I made some changes in the application I integrated? 

A: Head to Marketplace Settings > Integrations and click the Edit, Refresh, or Delete buttons to make these changes to your integration: 

Q: Can I integrate more than one instance of the same application?

A: You can! The Integration Engine allows you to connect as many instances of an application as you'd like.

Did this answer your question?