Manage notification delivery failures

When a Signature Request delivery mode is set to email, Yousign notifies recipients by email. Sometimes, these emails fail to reach their destination (invalid email, mailbox full, spam filter, etc.).

To give your systems full visibility, we expose notification delivery failure events via Webhooks.

This allows you to:

• Detect failed deliveries.
• Implement automated retries or alternative communication channels.
• Reduce manual monitoring and support workload.

Behavior:

• Only failure events trigger Webhooks. Notification delivery success events are not exposed via Webhooks.
• Only the initial notification delivery failure to a Signer or an Approver triggers an event. OTP, Reminders and Followers failed email delivery are not exposed.
• Webhooks are dispatched as soon as information is received from our email providers; delivery may not be instantaneous.
• If the error status of a notification changes, a new Webhook will be sent.

Delivery failure events are exposed via Webhooks through two events:

• signer.notification_delivery_failed
• approver.notification_delivery_failed

Consult our API reference to discover the full Webhook payloads for Approvers and Signers.

Delivery failure troubleshooting

Here you will find all the error statuses you can encounter when a notification delivery failure occurs, and the possible approaches to solve the problem.