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 email
  • request_body: additional message inserted into the body of the invitation email
  • reminder_subject: subject line of the reminder emails
  • reminder_body: additional message inserted into the body of the reminder emails

📘

request_body and reminder_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"
  }
}