Triggering Loops

​

Loop triggers

A Loop trigger is an event, contact update or contact addition that starts a Loop. For example, if you create a Loop that sends a welcome email to new contacts, the trigger would be when a new contact is added to your audience.

​

Different types of Loop triggers

There are currently three types of triggers that you can use to start a Loop: Contact Added, Contact Updated, and Event Received.

​

Contact Added

The Contact Added trigger will start a Loop when a contact is added to your audience. This trigger is useful for sending welcome emails to new contacts or sending a series of onboarding emails to new customers. It does not matter how the contact was added to your audience, whether it was through a form, or an API call. As long as the contact is added to your audience with an automatic method the Loop will start.

Two important things to know. First, if you add a contact manually, the Loop will not start. Second, this trigger requires no additional setup. Once you create a Loop with this trigger, you can start adding contacts to your audience and contacts will enter the Loop.

​

Contact Updated

The Contact Updated trigger will start a Loop when a contact is updated in your audience. This trigger is useful for sending emails to contacts based on their actions or behavior. For example, you can send a series of emails to contacts who change their subscription plan from free to paid or from paid to canceled.

You can also set the trigger to only start the Loop when a specific field is updated from a specific value to another specific value. For example, you can send a series of emails to contacts who change their subscription plan from free to paid but exclude contacts who have updated their subscription plan from paid to canceled.

​

Event Received

The Event Received trigger will start a Loop when a contact receives a speciifc matching event sent via API, Integrations or a form. This trigger is great for events like payment received, order placed, or a new message received.

​

Trigger frequency

You can choose to trigger a Loop just the first time a contact matches the trigger settinsg or every time the contact matches. For example, if you want to send to a contact every time they update their subscription plan, you can choose to trigger the Loop every time the contact is updated. However, if you want to send a welcome email to a contact just the first time they are added to your audience, you can choose to trigger the Loop once when the contact is added.

​

Changing the trigger type

You can change the trigger type at any time. For example, if you create a Loop with the Contact Added trigger, you can change it to the Contact Updated trigger at any time.