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 four types of triggers that you can use to start a Loop: Contact added, Contact updated, Contact added to list 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. This trigger works for contacts added via an integration, a form, or an API call. Contacts uploaded via CSV or added individually to the audience table will not be included. As long as the contact is added to your audience with an automatic method the Loop will start.

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.

​

Contact added to list

The Contact added to list trigger will start a Loop when a contact is added to a mailing list. It triggers every time a contact is added to a list (so if the contact is removed from a list and then re-added, it will trigger again).

​

Event received

The Event received trigger will start a Loop when a contact receives a specific 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 settings 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 (select “Every time”).

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 (select “One time”).

​

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.