How to create a scheduled email with Loops

This email type may also be referred to as a “rollup” email or a “summary” email. The idea is to send a single email that summarizes what’s happened in your app over a period of time.

These kinds of digest emails are a great way to keep your users engaged with your app.

The best way to do it today is a Loop with an event trigger set to fire “every time” with an event payload containing the updated property you’d like to send.

Then at the end of the day, week or month you can trigger a digest email with a summary of the events that happened.

​

Create the loop and event

Go to the Loops page and create a new loop.

Choose the Event is fired trigger. You will enter the loop editor.

Click on the Event received node and type the name of your event. You can re-use an existing event or create a new one from this input.

For example, you can use a name like sendDigest and then click + Create new event.

Next, click on the Edit event properties button to add properties to your event. Properties are extra pieces of data that you can attach to each event. This data is then made available in every email you send.

In the event editor overlay, click + Add event property and add any properties you want to include in your digest email.

Make sure the “Trigger frequency” dropdown in the Event received node has One time selected, as we only want to email each user once per event.

​

Create your email

The next step is to create the email you send to each contact.

Click on the Send email node and then Create email. This will open the email editor, where you can create your email.

When you want to add the event properties you created in the previous step, click the ⚡️ button above the editor.

You will see a list of each event property, which you can then insert into your email. Make sure to add fallback values for every property; if an event doesn’t have a value for a property in your email, the email will not send. Fallback values make sure that emails are sent to every contact.

When you’ve finished creating your email, click Start in the top right. This will make your loop active and you can start triggering it by sending events.

​

Trigger events

To send events to Loops you can use an integration, an SDK or our API.

With the API, it’s just a case of making a request to the Send event endpoint containing the contact’s details, the event name and your event properties.

{
  "eventName": "sendDigest",
  "email": "user1@gmail.com",
  "eventProperties": {
    ...
  }
}

​

Learn more