Introduction

Zapier is an online platform that helps you automate workflows by connecting your apps and services you use. Using the MoEngage <> Zapier integration, you can create custom workflow automations for more than 5,000+ apps on Zapier. 

The action "Import User Event" helps to import an event into MoEngage.

Use Cases

With this action, you can import custom events with triggers from multiple sources using Zapier. Some ideas to get you started - 

1. When there is a New Paid Order on Shopify, create a new event in MoEngage.
2. When a Google Form is submitted, add a new user action event in MoEngage. 
3. When a new Typeform entry is made, create a new event in MoEngage.
4. When a new HubSpot Engagement takes place, create a new event in MoEngage.
5. When a New Order is created in Mailchimp, create a new event in MoEngage. 

Integration

The action makes use of MoEngage Event APIs. For this tutorial, we will pick up Use Case #1: When there is a New Paid Order on Shopify, create a new event in MoEngage. On your Zapier Dashboard, and click on "+ Create Zap" on the top-left corner. 

Step 1: Select Shopify as the Trigger App

For the trigger, type "Shopify" and select it. This will be the trigger that will start your zap.

Step 2: Setup the trigger app

1. Select the event from the dropdown: "New Paid Order". Click continue.
2. Connect your Shopify Account, if not done already. Once selected, click continue.
3. Under the "Set up trigger" step, fill in the form as per your requirements.
4. Once you are satisfied with this data, click continue. 
5. You will then be provided an option to test this trigger. Click on "Test Trigger" and then "Continue".

Step 3: Add MoEngage as the Action app

Search for "MoEngage" from the apps and select it.

Step 4: Setup MoEngage Action

1. From the event dropdown, select: "Import User Event". Click continue.
2. If you have followed the prerequisites, you should see your MoEngage account already listed. You can either choose that or connect a new one. Click continue once done.
3. In the next step "Set up action", you will see a form for you to either fill-in or map from the previous step. Click here to know more.

Fill in all the mandatory fields and you will then be presented an option to test this setup. To understand how to fill up this form, please read the instructions on Event API. You can also choose to add custom attributes in the form of key-value pairs and map them to inputs from the previous trigger app:

Once you have selected your mapping data from the previous step, it should look like this:

4. For our setup, we have linked the following:
   1. Customer ID -> Shopify (Contact Email)
   2. Event ID -> "shopify_new_paid_order"
   3. Event Attributes -> customer_accepts_marketing -> Shopify (Customer Accepts Marketing)
   4. Event Attributes -> another_attribute -> "You can write your own values"
   5. Once you are satisfied with your mappings, click on "Continue".
5. You will now be presented with an option to test this setup.

6. Click on "Test & continue" to test this setup.
7. If the API call was successful, you should see a "success" return.

You can also verify this in your MoEngage dashboard. Go to your MoEngage Dashboard >> Settings >> Data Management >> Events >> Custom events tab >> search for  "shopify_new_paid_order".

8. Once you are satisfied that everything works, click on "Publish Zap" and it will run every time a new response is added to your Google Form.