Set up email provider

Many authentication use cases require sending emails to your users. Whether they are looking to verify their email address, reset their password, or be alerted of password changes, your users will need to receive these emails. This page shows the options for configuring email providers via the ReachFive Console.

See the Email templates page if you are looking for templates.

ReachFive integrates with the following email SaaS services:

We also provide:

generic integrations with SMTP servers.
an Email API to send the required information to a desired endpoint.

SMTP providers

You should use the SMTP provider to send emails if you have a reliable SMTP server available that will be able to handle all automated email distribution.

SMTP provider setup

In the ReachFive Console, go to Emails Providers.
Enter the SMTP configuration details.
1. Specify the From email address. This is what the recipients see as who sent the email.
2. Enter any Reply to email addresses that you wish to have. (Optional)
  
  When users reply, it will be sent to these emails.
3. Enter the host for your SMTP server.
4. Enter the port for that host SMTP server.
5. Enter your username for the SMTP server.
6. Enter the password associated with the above username for the SMTP server.
7. Check SSL or TLS depending on your requirements.
Select Send test email to validate the configuration.

The email is sent to the address of the user currently logged in.
Don’t forget to Save your input.

Custom providers

You should use the generic Email API to send emails when:

ReachFive Console does not provide a native integration with your SaaS solution. You need to implement the generic email API, and then send your emails from your system as you would.
You use a custom or in-house piece of software to manage emails. You will need to implement our generic API and then map the data sent to your template and email service.

Provider setup

In the ReachFive Console, go to Emails Providers.
Select Custom provider
Select the endpoint where you would like ReachFive Console to send email requests.

When sent, the REQUEST and payload are set and not customisable.

We consider any response excluding 4xx and 5xx a success.
If needed, enter the HTTP Authorization value. For example: Basic dm9yZGVsOnZvcmRlbA==. (Optional)
Select Send test email to validate the configuration.

The email is sent to the address of the user currently logged in.
Don’t forget to Save your input.

Select the endpoint where you would like ReachFive to send requests

An example request and payload are as follows:

POST https://YOUR_DOMAIN

{
  "email": "clarence@example.com",
  "template_id": "verify_email", (1)
  "personalizations": {
     "id": "id",
     "client_id": "jQy...TGlj",
     "external_id": "externalId",
     "given_name": "Max",
     "last_name": "Robertson",
     "gender": "M",
     "has_password": "true", (2)
     "lang": "fr",
     "locale": "fr-FR",
     "verification_code": "verificationCode",
     "redirect_url": "https://www.example.com/redirect"
   }
}

1	The `template_id` is the email template. This is the ID for the template found at Settings Emails Templates or alternatively for MFA at Settings MFA email templates.
2	The `has_password` boolean is only included in the payload for the `password_reset` template.

The has_password boolean gives custom providers the option to let users create a password.

true: The user already has a password; the user should be asked to reset the existing password.
false: The user does not have a password associated with their account; the user should be asked to create a password.

Custom personalization fields

The following are all of the possible personalizations you can use as part of the payload sent for custom providers.

Email

id
client_id
external_id
given_name
last_name
gender
has_password
lang
locale
verification_code
redirect_url

Adobe Campaign Standard

You can integrate your Adobe Campaign Standard account with ReachFive directly in the ReachFive Console allowing you to leverage the digital marketing campaigns and personalized messages already established with Adobe Campaign Standard.

This article only covers the steps in the ReachFive Console. You’ll need the following information from your Adobe account in order to proceed:

Tenant ID for Adobe Campaign Standard
Your Adobe Campaign Standard API Key
Your Adobe Campaign Standard Client secret
The Organization ID you want to access.
The Technical Account ID you want to access.
The Private Key that corresponds to the public key provided with your Adobe Campaign Standard settings.

For more information on how to find these items, see the Adobe Campaign Standard documentation.

Instructions

In the ReachFive Console, go to Emails Providers.
From the Client Type dropdown, choose Adobe Campaign Standard.
Enter your Tenant ID.
Enter your API Key.
Enter your Adobe Campaign Standard Client Secret.
Enter your Adobe Campaign Standard Organization ID.
Enter the Technical Account ID of the account you want to access.
Paste the Private Key that corresponds to the public key provided with your Adobe Campaign Standard settings.
Don’t forget to Save your input.

Dialog Insight

You can integrate your Dialog Insight account with ReachFive directly in the ReachFive Console allowing you to leverage the digital marketing campaigns and personalized messages already established with Dialog Insight.

This article only covers the steps in the ReachFive Console. You’ll need the following information from your Dialog Insight account in order to proceed:

Your Key ID.
Your Key.
Your Dialog Insight Project ID.

For more information on how to find these items, see Dialog Insight support.

Instructions

In the ReachFive Console, go to Emails Providers.
From the Client Type dropdown, choose Dialog Insight.
Enter your Key ID.
Enter your Key information.
Enter your Dialog Insight Project ID.
Don’t forget to Save your input.

Oracle Responsys

You can integrate your Oracle Responsys account with ReachFive directly in the ReachFive Console allowing you to leverage the digital marketing campaigns and personalized messages already established with Oracle Responsys Campaign Management.

This article only covers the steps in the ReachFive Console. You’ll need the following information from your Oracle account in order to proceed:

Endpoint ID for Oracle Responsys
Your Oracle Responsys Username
Your Oracle Responsys Password

For more information on how to find these items, see the Oracle Responsys Help Center.

Instructions

In the ReachFive Console, go to Emails Providers.
From the Client Type dropdown, choose Oracle Responsys.
Enter your Endpoint ID.
Enter your Oracle Responsys Username.
Enter your Oracle Responsys Password.
Don’t forget to Save your input.

Splio

You can integrate your Splio account with ReachFive directly in the ReachFive Console allowing you to leverage the digital marketing campaigns and personalized messages already established with Splio.

This article only covers the steps in the ReachFive Console. You’ll need the following information from your Splio account in order to proceed:

Your API Key.
Your Universe.
Your Splio Redirect URL Field ID.

For more information on how to find these items, see Splio resources.

Instructions

In the ReachFive Console, go to Emails Providers.
From the Client Type dropdown, choose Splio.
Enter your API Key.
Enter your Universe information.
Enter your Splio Redirect URL Field ID.
Don’t forget to Save your input.