IDM 7.3.1

Self-Service registration emails

To configure self-service registration emails, add the following code block to the selfservice-registration.json file:

    "name" : "emailValidation",
    "identityEmailField" : "mail",
    "emailServiceUrl" : "external/email",
    "emailServiceParameters" : {
        "waitForCompletion" : false
    "from" : "",
    "subject" : "Register new account",
    "mimeType" : "text/html",
    "subjectTranslations" : {
        "en" : "Register new account",
        "fr" : "Créer un nouveau compte"
    "messageTranslations" : {
        "en" : "<h3>This is your registration email.</h3><h4><a href=\"%link%\">Email verification link</a></h4>",
        "fr" : "<h3>Ceci est votre mail d'inscription.</h3><h4><a href=\"%link%\">Lien de vérification email</a></h4>"
    "verificationLinkToken" : "%link%",
    "verificationLink" : "https://localhost:8443/#/registration/"

The code block includes default registration email messages in English (en) and French (fr). The verificationLink sent with the email takes users to the IDM self-registration URL.

As noted in Managing User Self-Registration Over REST, you can make these changes over the endpoint URI: /openidm/config/selfservice/registration

To configure self-service registration emails using the admin UI:

  1. From the navigation bar, click Configure > User Registration.

  2. On the User Registration page, select the Options tab.

  3. Enable Email Validation.

    If the Email Validation option is disabled, outbound email has not been configured. Click Configure Here, and refer to Outbound email for more information.
  4. In the Configure Validation Email window, enter the necessary information, and click Save.

    Self-registration email changes made using the admin UI are saved to the selfservice-registration.json file.

Copyright © 2010-2024 ForgeRock, all rights reserved.