Sync data FROM another app to your app

A Flow moves data from one app to another. A Flow can have one or more Triggers that execute steps when run. Flows can sync data from or to your app from another app.

In this quick tutorial, we will build and run a flow that sends every new subscriber in a Mailchimp audience to your API endpoint.

To make things interesting, you will get to map custom fields in your Mailchimp account to fields of the API endpoint.

Note: You will need to login to a Mailchimp account, sign up for a free trial

Create a flow

1. Navigate to Flows and click Create a Flow button

2. Select the trigger: "Subscriber Created" in Mailchimp.

   
3. Click "Add a step" and select "HTTP Call". We will use this to call your API with the Mailchimp Subscriber data. If you don't have an API, Integr can write to your database, or Integry's own local store and expose an API.

   
4. Configure the HTTP Call: in this example, we will use webhook.site as a sample API endpoint

   1. On webhook.site: Click "Copy" to copy the unique URL

      
   2. Back in Integry's HTTP Call: Set the method HTTP call method to POST, and paste the URL.

      
   3. Switch to the "Body" tab of the HTTP call

   4. Define the JSON payload. In this example, we will send three fields to the API endpoint.

      1. Paste this JSON in the body:

         • {
              "email":"",
              "first_name":"",
              "last_name":""
           }

      2. Map the email field from the trigger to the body.

         1. Place your cursor in between the "" you just added, and click +. The mapping menu will popup.

            
         2. Click "Subscriber Created" under the Subscriber Created (Block)

         3. Click the ">" next to "Out" to access the output.

            
         4. In this example, event type and timestamp are at the root, while the data is in an array. Click "data" to open the array, and click "email".

            
         5. Confirm that the body looks like this:

            
         6. Now would be a good time to rename the flow and save it.

      3. Add the other two fields to the setup form.

         1. Click "Add fields to setup form..." at the bottom of the body container.

         2. Unselect "email" because we already mapped it. We want the user to map the other two at setup time. You can rename the titles if you want.

            
         3. Click "Add fields".

         4. Click "Setup Form" in the left pane, and go to the second page. Instead of "Acme Co.", it should have your app's name. You will see the two fields that you just added.

            
         5. Click "First Name" or "Last Name". You can see that the fields have been automatically configured to allow users to map fields from the trigger step. You don't need to do anything.

         6. Go back to "Trigger Blocks" and to the "Body" tab in "HTTP Call". You will see that the fields in the setup form (that you just added) have been automatically wired as the values of the fields to be sent to the API endpoint. You don't need to go anything here either.

            
   5. Now, simply Click "Test" to run this HTTP call to confirm that it's working.

      1. 
      2. Integry will ask you to provide an API key. Enter "123" and click Proceed.

         

         • You see this screen because Integry is assuming that webhook.site is your app, and the API call to the endpoint has to be authenticated with your credentials. Don't worry, your users won't have to give the API key in this manner because you will pass the key through the SDK when you embed the widget.

   6. You can see the request and response below.

      • "email" contains a sample value from the trigger's output that you mapped.

      • "first_name" and "last_name" are empty because they've not been mapped as yet. You will get to map them (like your users) in the next section when you setup an integration of this flow.

      
5. Save the flow and go back to the Flows list.

That's it! The flow is ready to use.

Set up an integration of the flow

1. Click "Embed". You'll see the flow you created. In this example, that's "Sync new subscribers from Mailchimp".

2. Click "Setup and enable".

3. Login to Mailchimp.

4. Configure Mailchimp.

   1. Select the audience you want to monitor for new subscriber and click Next.

      
5. Configure Acme Co.

   1. Map Acme Co. fields to Mailchimp fields.

      
6. Click Save to initialize the integration.

Almost there! The integration is now live and ready to be triggered.

Run the integration

In this example, we are using a Mailchimp trigger so steps 1-5 will happen in Mailchimp.

1. Open mailchimp.com in a browser.
2. Log in with the same user account you used while setting up the integration.

   1. If you have multiple team accounts, select the same team account you selected earlier.

3. Click "Add subscriber".

4. Fill out the form with a new user's details.

   
5. Give permission to email the user, and click Subscribe.

   
6. Go back to webhook.site. A new request with the details you entered should have been received.

7. You can also see how the run actually executed by clicking the count of users against this flow (in the flows list), drill down to runs, and then steps.

We're done! You just created a flow between two apps, setup an integration of the flow, and the integration ran.

Next steps

• Make flows that send data to another app, import data from an app, export data to an app, or even sync both ways between another app and your app.
• Embed the Integry widget in your app so your users can set up integrations from within your app