Didomi - Developers documentation
  • Introduction
  • SDKs
    • Introduction
    • Web SDK
      • Getting started
      • Tags and vendors management
        • Tags management
          • Events & Variables
            • Deprecated
            • Custom events
          • Tag managers
            • Adobe Launch/DTM
            • Eulerian
            • Google Tag Manager
              • Configure the Didomi / GTM integration
              • Didomi's GTM template
            • Tealium
            • Other tag managers
        • Custom Didomi <script> tags
        • Third-party integrations
          • Google Ad Manager / AdSense
            • GDPR via Non-Personalized Ads
              • Share consent and load/refresh ads
              • Share consent without loading or refreshing ads
            • US states laws
          • Google Consent Mode V2
          • Kameleoon
          • Piano Analytics (AT Internet)
          • Prebid
            • GDPR via IAB TCF
            • US states laws
          • Salesforce DMP (Krux)
        • IAB frameworks
        • Programmatic API
      • Configuration
        • Bots (SEO & Performance tools)
        • Configuration by URL
        • Cookies and storage
        • Custom domains for events
        • Notice
          • Behavior
          • Interactions
          • Look and feel
        • Preferences
        • Theme
      • AB tests
      • Custom domain
        • Domain delegation
        • Reverse proxy
      • Share consents between domains
      • Share consents across devices
      • Pass user choices in query string
      • Serve Didomi assets from your domain
      • Reference
        • API
          • Deprecated
        • Events
      • Performance
    • Mobile and TV SDKs
      • Android and Android TV
        • Setup
        • Logging
        • Reference
          • API
            • Deprecated
          • Events
        • Versions
      • iOS and tvOS
        • Setup
        • Logging
        • App Tracking Transparency (iOS 14.5+)
        • Reference
          • API
            • Deprecated
          • Events
        • Versions
      • Unity
        • Setup
        • Reference
        • Versions
        • Troubleshooting
      • React Native
        • Setup
        • Reference
          • Deprecated
        • Versions
      • Flutter
        • Setup
        • Reference
        • Versions
      • Consent notice
        • Getting started
        • Customize the notice
        • Customize the preferences popup
        • Customize the theme & UI
        • Load notice by ID
      • Third-party SDKs
      • Share consents across devices
      • Share consent with WebViews
      • Google Consent Mode v2
      • FAQ
    • AMP SDK
      • Blocking Behaviors
        • Load immediately on page load
        • Load only after consent (positive or negative)
        • Load only after positive consent
      • Consent status for vendors
    • Help & Support
  • API
    • Introduction
      • Authentication
      • Errors
      • Pagination
      • Filters
      • Caching
      • Rate limiting
      • Quotas
      • Translations
    • Data Manager
      • Regulations
      • Configuration Tree
      • Purposes
        • Purposes & Vendors Numerical IDs
      • Preferences Library
      • User Rights
    • Widgets
      • Consent notices
        • Notices
        • Configurations
        • Multi-Regulation Configurations
          • Migration of Existing Notices and API Updates
        • Deployments
        • Tutorials
          • Create and publish a consent notice
          • Create and publish a multi-regulation consent notice
      • Privacy widgets
        • Create a widget
        • Retrieve widgets
        • Edit a widget
          • Content & Design
            • Themes & Shapes
            • Components
              • auth
              • dsar_form
              • footer
              • header
              • preference
              • preference_value
              • save
              • section
              • sections
            • Options
          • Purposes & preferences
          • Settings
        • Deploy a Widget
          • Use your own subdomain
          • Use your own domain
          • Implement an embeddable widget on your website
        • Authentication
          • Manage authentication providers
          • Authenticate your end-user
        • Archive a widget
        • Headless widgets
          • Public Methods
          • Custom elements
          • Custom events
          • Event listeners
        • Tutorial
          • Launch a Preference Center from a mobile app
    • Compliance Reports
      • Properties
      • Reports
      • CSV format reference
      • Websites
    • Consents and Preferences
      • Events
        • Generate IAB TCF consent string
      • Links
      • Proofs
      • Tokens
      • Secrets
      • Users
      • Tutorial
        • Collect and operate data
    • Privacy Requests
      • Requests
      • Notes
      • Links
      • Emails
  • Integrations
    • Introduction
      • Quotas
    • Generic integrations
      • Batch export
        • Destinations
          • AWS S3 Bucket (owned by Didomi)
          • GCP Storage Bucket
        • Exported data
          • Notices consents
        • Logs
      • Webhooks
      • Batch import
      • Analytics export
        • Destinations
          • AWS S3 Bucket (owned by Didomi)
          • GCP Storage Bucket
    • Third-party apps
      • CMP integrations
        • Didomi-mParticle integration for your CMP
        • Deploy Didomi’s SDK for your Adobe Commerce website
      • Preference Management Platform integrations
        • Actito
        • Adobe Campaign Classic
        • Adobe Experience Cloud
        • Adobe Marketo Engage
        • Adobe Source Connector
        • Braze
        • Dotdigital
        • Hubspot
        • Mailchimp
        • Microsoft Dynamics 365
        • Salesforce Marketing Cloud
        • Salesforce Sales & Service Cloud
        • Selligent
        • Brevo (ex Sendinblue)
    • Tutorials
      • Configure a HTTP webhook
      • Configure a batch export
      • Configure an analytics export
    • Emailing
      • Configurations
        • Actito Email
        • Actito SMS
        • Adobe Campaign Classic
        • Adobe Campaign Standard
      • Emails
        • Templates
        • Manage your templates
Powered by GitBook
On this page
  • Templates
  • Consents API
  • Confirmation of changes
  • User created
  • Validation - Approval - File
  • Validation - Approval - Signature
  • Validation - Double opt-in
  • Metadata from consents events to email templates
  • Preference Management Platform
  • Authentication - Magic Link
  • Authentication - One-Time Password
  • Privacy request module
  • Access Data Request fulfillment notification
  • Delete data request fulfillment notification
  • Identity verification
  • Opt out request fulfillment notification
  • Refusal notification
  • User created
  • Validation - Approval - File
  • Validation - Approval - Signature
  • Validation - Double opt-in
  • Work in progress notification
  1. Integrations
  2. Emailing
  3. Emails

Templates

PreviousEmailsNextManage your templates

Last updated 1 year ago

Templates

We support the following templates:

Consents API

Preference Management Platform

Privacy request module

Consents API

Confirmation of changes

Template ID: confirm-consent-changed

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

Parameters

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

User created

Template ID: consents-user-created

Send a welcome message to the user with an authenticated link to the Preference Center when the user is created through their first consent event.

Parameters

The following parameters are provided to the template when sending a welcome message:

Name
Description

privacy_center_url

URL of the Preference Center with a valid consent token.

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 for approving 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 for approving 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 confirm their consent choices. This should be used as the URL for a link or button in the email.

Metadata from consents events to email templates

Didomi allows you to use metadata attached to the consent events created from the API in the email sent to the end-user. By adding metadata to the consent event, you can include a custom parameter in the template to access the information recorded during consent.

Add metadata reference in Consent event

POST /consents/events?organization_id={organization_id}

{
  "user": {
    "organization_user_id": "user@domain.com",
    "metadata": {
      "redirect_url": "https://google.com"
    }
  },
  "consents": {
    "purposes": [
      {
        "id": "purpose_id",
        "enabled": true
      }
    ]
  }
}

Add parameter in the email template

To add a metadata parameter in the email template, construct the parameter using the following format:

{{metadata_PROPERTY_IN_METADATA}}

And add this parameter in your email template:

POST /marketplace/emails?organization_id=YOUR_ORGANIZATION_ID

{
    "type_id": "didomi", 
    "email_type": "validation-double-optin",
    "properties": {
        "html": "<html>\n<head>\n<title>Privacy Center Approval</title>\n
                </head>\n<body>\n<div>\nCliquez ici pour confirmer votre 
                consentement: <a href=\"{{validation_approve_url}}
                &redirect_url={{metadata_redirect_url}}\">{{validation_approve_url}}
                </a>\n</div>\n</body>\n</html>"
    }
}

Preference Management Platform

Authentication - Magic Link

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 a Magic Link authentication email:

Name
Description

privacy_center_url

URL of the Preference Center with a valid consent token.

Authentication - One-Time Password

Template ID: privacy-center-auth-otp-code

Send a 6-digit code to users when they access a Preference Center without a valid consent token. The email allows users to receive a code to submit for accessing a Preference Center for the associated email address.

Parameters

The following parameters are provided to the template when sending a One-Time password authentication email:

Name

Description

code

6-digit code to submit in the widget.

Privacy request module

Access Data Request fulfillment notification

ID: request-status-fulfilled-access-my-data

Send an email to the end-user after setting the status of an access data request to fulfilled.

Type
Description

download_link

Link that redirects users on a webpage to access or download their data. This should be used as a button or a link.

Delete data request fulfillment notification

ID: request-status-fulfilled-delete-my-data

Send an email to the end-user after setting the status of a delete data request to fulfilled.

Type
Description

user_right_label

Right expressed by the end-user while submitting the privacy request. This should be used as a label or a title to recall the right the end-user has submitted.

Identity verification

ID: request-verify

Parameters

Name
Description

user_right_label

Right expressed by the end-user while submitting the privacy request. This should be used as a label or a title to recall the right the end-user has submitted.

confirmation_link

Redirection link to validate user identity. This should be used in a button or link.

Opt out request fulfillment notification

ID: request-status-fulfilled-opt-out

Send an email to the end-user after setting the status of an opt-out request to fulfilled.

Type
Description

user_right_label

Right expressed by the end-user while submitting the privacy request. This should be used as a label or a title to recall the right the end-user has submitted.

Refusal notification

ID: request-status-refused

Send an email to the end-user after request status has been set to refused.

Type
Description

user_right_label

Right expressed by the end-user while submitting the privacy request. This should be used as a label or a title to recall the right the end-user has submitted.

User created

Template ID: consents-user-created

Send a welcome message to the user with an authenticated link to the Preference Center when the user is created through their first consent event.

Parameters

The following parameters are provided to the template when sending a welcome message:

Name
Description

privacy_center_url

URL of the Preference Center with a valid consent token.

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 for approving 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 for approving 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 confirm their consent choices. This should be used as the URL for a link or button in the email.

Work in progress notification

ID: request-status-wip

Send an email to the end-user after request status has been set to work_in_progress.

Type
Description

user_right_label

Right expressed by the end-user while submitting the privacy request. This should be used as a label or a title to recall the right the end-user has submitted.


To populate the download_link variable, you need to add download_link property under extra_message_variables while the related request.

Send an email to the end-user after a privacy request is submitted in order to validate identity. The request must be created with an .

Some emails )(such as Authentication emails or Privacy request emails) are already available by default. The other templates mentioned above need to be .

created in Didomi APIs
Confirmation of changes
User created
Validation - Approval - File
Validation - Approval - Signature
Validation - Double opt-in
Authentication - Magic Link
Authentication - One-Time Password
Access Data Request fulfillment notification
Delete Data Request fulfillment notification
Identity verification
Opt out Data request fulfillment notification
Refusal notification
Work in progress notification
updating
approval workflow