Auth0

Set up an SMTP connection to send all of your Auth0 emails with Loops.

There are two big benefits to using Loops for sending your Auth0 emails:

​

Set up Loops SMTP in Auth0

Go to Branding -> Email Provider in your Auth0 dashboard.

Scroll down and click on SMTP Provider.

In the SMTP Provider Settings section below, enter a value into the “From” field. This value will always be overwritten by the values set in your Loops templates from the next step, so it can be anything.

In the SMTP Provider Settings section enter the following data:

​

Create Transactional emails in Loops

Next, create new transactional emails for the emails you are sending from Auth0. Go to Branding -> Email Templates to view the full list.

In Loops, go to the Transactional page and click New. Alternatively, you can select one of our many ready-made templates from the Templates page.

You can then use the Loops editor to create nicely-designed templates or make them as simple as you like.

You can even create themes to apply consistent design and branding to all of your emails.

For each Loops template you create, you need to add data variables, which allow data from Auth0 to be inserted into each email.

You can check the list of Common variables supported in each email from the Auth0 documentation.

Once you’re done creating the email and adding the data variables, click Next. On the next page, click the Show payload button to view the API payload for your template. You will need this for the next step.

Make sure to also publish your email! It won’t send unless it’s published.

​

Configure email templates in Auth0

The final step is to make sure your emails in Auth0 are configured to send the correct data to Loops.

Loops SMTP integrations work a bit differently than most. Instead of sending a text or HTML email body, you set them up to send API-like data.

In Auth0, go to Branding -> Email Templates, then edit each template to contain the payload as shown in the previous step (you can click the clipboard icon in Loops to copy the full payload).

If you are using Passwordless authentication, add your Loops payload into the Body field at Authentication -> Passwordless -> Email.

Once pasted into the Message body, you need to add the Auth0 message variables into the payload. You can do this using double curly brackets like {{ url }}.

Here is an example “Verification Email (using Link)” email template. This payload was copied from the template’s Publish page in Loops, then the {{ user.email }} and {{ url }} Auth0 variables were added.

{
  "transactionalId": "clvmzp39u035tl50pw7wrl0ri",
  "email": "{{ user.email }}",
  "dataVariables": {
    "productName": "{{ application.name }}",
    "url": "{{ url }}"
  }
}

If you want to add each Auth0 user to your Loops audience so you can send marketing email to them, add the addToAudience flag to your template as below. This will create a contact in Loops using the {{ user.email }} value.

{
  "transactionalId": "clvmzp39u035tl50pw7wrl0ri",
  "email": "{{ user.email }}",
  "addToAudience": true,
  "dataVariables": {
    "productName": "{{ application.name }}",
    "url": "{{ url }}"
  }
}

Here’s how the template looks in the Auth0 editor:

To test that everything works, click the Try button beneath the editor. Insert your email address in the modal that appears, then click Try to send the email.

You will also be able to see activity for your email sends in Monitoring -> Logs.

The best way to view your Auth0 email history is in Loops. Go to your Transactional page then click on one of your emails. Click on Metrics in the left menu to view a page containing a table showing all sends and some statistics.

​

Important notes

• The subject in Auth0 templates is always overwritten by the subject added to the corresponding template in Loops.
• The sender email configured in your Auth0 SMTP settings is always overwritten by the “From” address added to your templates in Loops.
• Any enabled Auth0 template not set up with the correct API-like payload will fail to send.