Templates

When sending an email, Didomi specifies a template ID from the emailing provider to define what the email content is. You need to pre-create those templates for the emails to be correctly sent.

As Didomi sends different types of emails, you need to create the templates associated with every email type that will be sent for your organization. Didomi also pushes context information (variables) that you can use in your templates.

We support the following templates.

Authentication

Template ID: privacy-center-auth

Send an authentication link to users when they access a Preference Center without a valid consent token. The email allows users to confirm their identity and access a Preference Center for the associated email address.

Parameters

The following parameters are provided to the template when sending an authentication email:

Name

Description

privacy_center_url

URL of the Preference Center with a valid consent token.

Confirmation of changes

Template ID: confirm-consent-changed

Send a confirmation email to let the user know that their changes have been correctly taken into account.

Parameters

No parameters are provided when sending a confirmation of changes email.

Validation - Approval - File

Template ID: validation-approval-file

Approval request for confirming changes to a user consent status from an event that uses the file validation method. Approval requests are similar to double opt-in but are intended to be processed internally while double opt-in is a confirmation from the end user directly.

Parameters

The following parameters are provided to the template when sending an approval email:

Name

Description

validation_approve_url

URL to redirect the user to for approving the consent choices. This should be used as the URL for a link or button in the email.

Validation - Approval - Signature

Template ID: validation-approval-signature

Approval request for confirming changes to a user consent status from an event that uses the signature validation method. Approval requests are similar to double opt-in but are intended to be processed internally while double opt-in is a confirmation from the end user directly.

Parameters

The following parameters are provided to the template when sending an approval email:

Name

Description

validation_approve_url

URL to redirect the user to for approving the consent choices. This should be used as the URL for a link or button in the email.

Validation - Double opt-in

Template ID: validation-double-optin

Collect double opt-in for a consent event that uses the email validation method. This allows users to confirm their choices before a consent event is stored.

Parameters

The following parameters are provided to the template when sending a double opt-in email:

Name

Description

validation_approve_url

URL to redirect the user to for confirming their consent choices. This should be used as the URL for a link or button in the email.