Email customization
Customize the appearance of emails received by recipients
When a Custom Experience is associated with a Signature Request, it also affects the look and feel of the emails.
For more details, see the dedicated guide.
Customise the content of emails received by recipients
Customize the content of emails received by recipients (Signers and Approvers) to align with your brand identity or provide specific instructions.
How it works
You can personalize invitation and reminder emails using the custom_text
parameter.
The following fields are available:
request_subject
: subject line of the invitation emailrequest_body
: additional message inserted into the body of the invitation emailreminder_subject
: subject line of the reminder emailsreminder_body
: additional message inserted into the body of the reminder emails
request_body
andreminder_body
fields allow you to insert custom content into the email templates defined by Yousign. They do not replace the entire email body — the custom message will appear within the standard email layout provided by Yousign.
Customization can be defined in two ways:
- At the Signature Request level: applies to all recipients (Signers and Approvers).
- At the individual recipient level: applies only to the specific recipient and overrides any values defined at the Signature Request level.
Formatting rules:
- Use
\n
for line breaks in the message content. - HTML tags and clickable links are not supported to ensure security and compatibility across emails clients.
Examples
Here are example payloads showing how to customize emails at the Signature Request, Approver, and Signer levels.
{
"name": "Name of the SR",
"delivery_mode": "email",
"email_notification": {
"custom_text": {
"request_subject": "New subject",
"request_body": "The body of the email I want to display",
"reminder_subject": "New reminder subject",
"reminder_body": "The body of the email reminder I want to display"
}
}
}
{
"info": {
"first_name": "randomFirstName",
"last_name": "randomLastName",
"email": "[email protected]",
"locale": "en",
"phone_number": "+33600000000"
},
"custom_text": {
"request_subject": "New subject",
"request_body": "The body of the email I want to display",
"reminder_subject": "New reminder subject",
"reminder_body": "The body of the email reminder I want to display"
}
}
Updated 8 days ago