Loops (Actions) Destination

Loops is a modern email platform for SaaS, a better way to send marketing and transactional email.

You can use this Segment destination to create and update your Loops contacts and trigger email sending with events.

Loops maintains this destination. For any issues with the destination, contact their Support team.

Getting started

  1. From the Segment web app, click Catalog, then click Destinations.
  2. Search for “Loops (Actions)” in the Destinations Catalog, and select the destination.
  3. Click Configure Loops.
  4. Select an existing Source to connect to Loops and click Next.
  5. On the Setup page, enter a name for your destination and click Create destination.
  6. Open Loops and generate an API key from Settings > API. Click “Generate key” then click the “Copy to clipboard” icon.
  7. Open the Segment app, go to the Settings page inside your Loops destination, and paste your API key. Then, click “Save Changes”.

Create or update contacts

You can create and update Loops contacts by using Segment’s Identify method, like this:

analytics.identify("test-user-a5h7xb", {
  email: "adam@loops.so",
  firstName: "Adam",
  favoriteColor: "blue",
  favoriteNumber: 42
});

If the email address or user ID do not exist in your contacts, a new contact will be created. If the email address or user ID already exists, the existing contact will be updated with the data sent in the Identify call.

Go to the Mappings tab inside your Loops destination and click New Mapping. Select Create or update a contact.

It is important that you set up the data mapping properly in step 3 of the “Create or update a contact” form. This is where you can select which data is sent on to Loops and into which fields. Loops provides an example default mapping in the form, but you should make sure that you set up the mapping to capture the correct data in the correct fields (you may have some custom fields in Loops that the default mapping doesn’t cover, for example).

You can pass any custom fields that you’re using in Loops inside “Custom Contact Attributes”.

Once you have completed the mapping you can send a test event. After you submit a test event, you can verify everything is set up correctly by looking for the contact on the Audience page in your Loops account.

Loops has a full tutorial for creating and updating contacts in the Loops docs.

Sending events

In Loops you can send emails triggered by events. You can trigger these events from Segment by using the Track method, like this:

analytics.track("User Registered");

When you make a Track call, Segment will pass this event data on to Loops, which can then send emails based on email-sending triggers you’ve set up in your account.

To set up event sending with Segment, go to the Mappings tab inside your Loops destination and click New Mapping. Select Send Event.

In the next page, enter the name of the event you’re tracking into the “Event Name” field (for example, “User Registered” from the example above). If you have not already created the contact in Loops, you need to include an email address in your mapping, as Loops requires a contact for each event.

Now you are able to send a test event. You can verify that the event was triggered properly in your Loops account from the Events page.

Read the tutorial for sending events in the Loops docs.

Destination Settings

Setting Description
API Key Required.

Your Loops API Key

Available Actions

Build your own Mappings. Combine supported triggers with the following Loops-supported actions:

Mapping limits per destination

Individual destination instances have support a maximum of 50 mappings.

Create or update a contact

Create or update a contact in Loops

Create or update a contact is a Cloud action. The default Trigger is: type = "identify"

Click to show / hide fields

Field Description
Contact Created Date Type: DATETIME

Date the contact was created.

Custom Contact Attributes Type: OBJECT

Contact attributes maintained by your team.

Contact Email Type: STRING

Email address for the contact. This is required when creating new contacts.

First Name Type: STRING

The contact’s given name.

Last Name Type: STRING

The contact’s surname.

Mailing Lists Type: OBJECT

An array of objects containing key-value pairs of mailing list IDs as listId and a true/false subscribed value determining if the contact should be added to or removed from each list.

Source Type: STRING

The contact’s source.

Subscribed Type: BOOLEAN

Whether the contact is subscribed to email.

User Group Type: STRING

The contact’s user group.

User ID* Type: STRING

User ID for the contact.

Send Event

Send an event for a contact in Loops

Send Event is a Cloud action. The default Trigger is: type = "track"

Click to show / hide fields

Field Description
Contact Email Type: STRING

Email address for the contact.

Event Name* Type: STRING

Name of the event.

User ID* Type: STRING

User ID for the contact.

Event Properties Type: OBJECT

Event-specific properties that can be included in emails triggered by this event.

This page was last modified: 12 Oct 2023



Get started with Segment

Segment is the easiest way to integrate your websites & mobile apps data to over 300 analytics and growth tools.
or
Create free account