You have different options to control what email notifications are sent to recipients, with different levels of granularity.

There are two main levers:

• Turn off all emails for recipients with delivery_mode = none.
• Keep emails active, but turn off specific messages only (via Custom Experience or the exclusion list).

Disable all emails with delivery_mode set to none

delivery_mode is a parameter that lets you turn all recipient emails on or off. It affects Signers, Approvers, Followers and Senders.

It has two possible values:

• email → Yousign sends all emails to recipients during the signature flow (signature link, status updates, reminders, etc.). This is the best option if you want to delegate email management to Yousign.
• none → Yousign does not send any email. You are then responsible for sending the signature link and any updates through your own channels (email, SMS, in‑app notifications, etc.). Choose this if you want to control the recipient flow by yourself, and choose the delivery method.

You can set delivery_mode at two levels:

At Signature Request level

Set delivery_mode = none when you create the Signature Request.

All recipients in that Signature Request (Signers, Approvers, Followers, Sender) will receive no emails from Yousign.

• Endpoint: Initiate a new Signature Request

At Signer level

Set delivery_mode = none when you create a new Signer.

In this case, only this Signer will receive no emails from Yousign.

• Endpoint: Create a new Signer

Examples:

POST /signature_requests

{
  "name": "My Signature Request",
  "delivery_mode": "none"
}

POST /signature_requests/{signatureRequestId}/signers

{
  "info": {
    "first_name": "Kelly",
    "last_name": "Smith",
    "email": "[email protected]",
    "locale": "en"
  },
  "signature_level": "electronic_signature",
  "signature_authentication_mode": "no_otp",
  "delivery_mode": "none"
}

Disable specific emails (keep others active)

If you don’t want to fully turn emails off, you can keep email delivery enabled and select which messages to disable.

You have two ways to do this:

1. Using the Custom Experience
2. Using the exclusion list (for a specific Signer)

1. Using the Custom Experience

With a Custom Experience, you can uncheck certain email types for Signers, Approvers, Followers and the Sender. These settings apply to all recipients in any Signature Request that uses this Custom Experience.

Use this if you want the same notification rules for everyone in the Signature Request.

To learn more, see Custom Experience.

2. Using the exclusion list (for a specific Signer)

You can attach an email exclusion list to a given Signer.

On the Signer resource, set email_notification.disabled with an array of email keys you want to mute for that Signer. If a key is in this list, Yousign will skip that specific email for that Signer. Other recipients will still receive their own emails as usual.

• Endpoint: Create a new Signer

Example:

POST /signature_requests/{signatureRequestId}/signers

{
  "info": {
    "locale": "en",
    "first_name": "Kelly",
    "last_name": "Smith",
    "email": "[email protected]"
  },
  "signature_level": "electronic_signature",
  "signature_authentication_mode": "no_otp",
  "email_notification": {
    "disabled": [
      "signer.signature_request_updated.new_expiration_date",
      "signer.signature_request_signature_requested.reminder_to_sign"
    ]
  }
}

Find the complete list of email keys here:

Important:

This exclusion list works only if delivery_mode = email. If you change the Signer to delivery_mode = none, the exclusion list is reset to null, since no emails will be sent at all.

Notes

• If you disable the first delivery email, you must send the signature link yourself. See Manage signature link delivery.
• If you run your own notification system, you can use webhooks to react to events (for example, when a request is activated or signed). See Webhooks.
• Some emails cannot be disabled:
  • Identity Verification emails for Advanced Electronic Signature (AES) and Qualified Electronic Signature (QES).
  • Renewal‑link emails sent to a Signer/Approver/Follower who requests a new link after their previous signing link has expired.