Loops Beta

Loops is an email platform for SaaS companies for sending marketing and transactional emails from the same platform.

This integration is built by the Loops team. Contact the Loops support team for any assistance.

Find the open source transformer code for this destination in the GitHub repository.

Connection compatibility

Get started

Once you have confirmed that the platform supports sending events to Loops, follow these steps:

1. From your RudderStack dashboard, add the source. Then, from the list of destinations, select Loops.
2. Assign a name to your destination and click Continue.

Connection settings

Identify

You can use the identify event to create or update contacts in Loops.

A sample identify call is as shown:

rudderanalytics.identify("1hKOmRA4GRlmr123", {
  email: "alex@example.com", // Required for new contacts
  name: "Alex Keener",
  country: "United States",
})

Make sure to pass the unique user identifier as the first parameter in your identify call.

Note that:

• email is a required field for adding new contacts in Loops.
• The existing contacts are updated in Loops based on the provided userId property. If an existing contact in Loops doesn’t have a userId, Loops attempts to match based on the provided email.
• The identify traits are automatically added to the contact record as properties.

Manage mailing list subscriptions

To manage a contact’s mailing list subscriptions, add a mailingLists property to match the expected API format:

rudderanalytics.identify("1hKOmRA4GRlmr123", {
  email: "alex@example.com",
  name: "Alex Keener",
  country: "United States",
  mailinglists: {
    clxf1nxlb000t0ml79ajwcsj0: true,
  },
})

In the above example, the contact with the identifier 1hKOmRA4GRlmr123 is added to the mailing list with the ID clxf1nxlb000t0ml79ajwcsj0.

Track

You can use the track event to send user actions to Loops, which in turn are used to trigger loops.

Your track events will appear on the Settings > Events page in the Loops dashboard.

A sample track call sent to Loops is shown below:

rudderanalytics.track("Signup", {
  firstName: "Alex",
  email: "alex@example.com",
  plan: "Pro"
})

Note that:

• If you omit both the email and userId fields from your track calls, you must identify the current user first by calling identify.
• The track event name should match the name of the event in Loops. Also, the event properties must match the properties in Loops. You can set these up by going to Settings > Events in your Loops dashboard.
• You can include event properties in the track event so you can use them inside your loop emails.
• RudderStack persists any values in context.traits from a previous identify call in the track event properties and updates the contact record in Loops accordingly.

FAQ

Where can I find the Loops API key?

1. Go to your Loops API Settings page.
2. Generate or use an existing API key.
3. Copy the key and paste it in the API Key field in the RudderStack dashboard.

Questions? Contact us by email or on Slack