Manage your templates
To create your own email template, you need to benefit from Integrations V2 Premium feature. Please reach out to our Support team ([email protected]) to get more information.
To create a new email template, send a POST request on
/marketplace/emails
endpoint and specify following properties:Property | Description |
---|---|
type_id | Email provider id ( didomi ) |
email_type | Email template id |
properties.html | Email template (HTML) |
properties.subject | Email subject |
properties.reply_to | Email addresses set in the reply-to |
POST https://api.didomi.io/marketplace/emails?organization_id=YOUR_ORGANIZATION_ID
{
"type_id": "didomi",
/**
* Email types available are detailled above.
* For instance, to verify user identity,
* in context of a Privacy request collection
* you will be using `request-verify` email
*/
"email_type": "TEMPLATE_ID",
"properties": {
"html": "YOUR_HTML",
"subject": "EMAIL_SUBJECT",
"reply_to": ["EMAIL_ADDRESS"]
}
}
Important: take care when editing the
properties
property. This is a JSONB and, by design, you need to fill in every property already added every time you edit this object. If you have added your own HTML and now want to set a reply_to
, you need to provide both html
and reply_to
in order not to erase your previous changes. 💡 Note: this section only refers to
didomi
providers. You can also use your own provider: the workflow will look the same, however further configuration will be required. To fetch provider configuration schemas, send a GET request on /marketplace/emails/properties-schema
.To list email templates, send a GET request on
/marketplace/emails
endpoint.GET https://api.didomi.io/marketplace/emails?organization_id=YOUR_ORGANIZATION_ID
[
{
"type_id": "didomi",
"email_type": "TEMPLATE_ID",
"properties": {
"html": "YOUR_HTML",
"subject": "EMAIL_SUBJECT",
"reply_to": ["EMAIL_ADDRESS"]
}
}
]
Last modified 20d ago