# Webhook Events

Definitions for asynchronous event payloads sent by Signable.

## Envelope sent

 - [POST send-envelope](https://developers.signable.app/openapi/webhook-events/receivesendenvelopewebhook.md): This webhook is triggered after an envelope has been successfully processed and sent. It delivers information about the envelope, the recipient, and any additional metadata.

## Envelope signed

 - [POST signed-envelope](https://developers.signable.app/openapi/webhook-events/receivesignedenvelopewebhook.md): This webhook is triggered when a recipient completes signing an envelope. It includes detailed information about the envelope, signer, documents, custom fields, and signature fingerprint.

## Envelope cancelled

 - [POST cancelled-envelope](https://developers.signable.app/openapi/webhook-events/receivecancelledenvelopewebhook.md): This webhook is triggered when an envelope is cancelled before completion. It includes the envelope fingerprint, user details, and any metadata associated with the envelope.

## Envelope expired

 - [POST expired-envelope](https://developers.signable.app/openapi/webhook-events/receiveexpiredenvelopewebhook.md): This webhook is triggered when an envelope expires. It includes basic information about the envelope and the recipient.

## Envelope signed and complete

 - [POST signed-envelope-complete](https://developers.signable.app/openapi/webhook-events/receivesignedenvelopecompletewebhook.md): This webhook is triggered when all required parties have completed signing an envelope. It includes the envelope fingerprint, documents, and any captured field data. For QES envelopes, it is sent after the last QES signer has verified.

## QES verification ready

 - [POST qes-ready](https://developers.signable.app/openapi/webhook-events/receiveqesreadywebhook.md): This webhook is triggered when a QES signer's verification session is created and they can verify their identity. It is sent once for each QES signer, in signing order, while the envelope is qes_in_progress. It is not sent again if an existing session is reused. See the QES guide for the full flow.

## QES signer complete

 - [POST qes-signed](https://developers.signable.app/openapi/webhook-events/receiveqessignedwebhook.md): This webhook is triggered when a QES signer has verified their identity and their qualified signature has been applied. It is sent once for each QES signer. After the last QES signer, signed-envelope-complete is sent. See the QES guide for the full flow.

## QES signing failed

 - [POST qes-failed](https://developers.signable.app/openapi/webhook-events/receiveqesfailedwebhook.md): This webhook is triggered when QES signing fails while the envelope is qes_in_progress. The envelope status changes to failed and no further QES signers can verify. Unused QES credit reservations are released. See the QES guide for the full flow.

## Envelope rejected

 - [POST rejected-envelope](https://developers.signable.app/openapi/webhook-events/receiverejectedenvelopewebhook.md): This webhook is triggered when a recipient rejects an envelope. It includes details about the envelope, the rejecting contact, and relevant metadata.

## Envelope opened

 - [POST opened-envelope](https://developers.signable.app/openapi/webhook-events/receiveopenedenvelopewebhook.md): This webhook is triggered when a recipient opens an envelope. It includes basic information about the envelope, the recipient, and associated documents.

## Envelope email bounced

 - [POST bounced-envelope](https://developers.signable.app/openapi/webhook-events/receivebouncedenvelopewebhook.md): Triggered when an email to a signer fails to deliver.

## Envelope send failed

 - [POST send-envelope-failed](https://developers.signable.app/openapi/webhook-events/receivesendenvelopefailedwebhook.md): This webhook is triggered when an envelope fails to send. The envelope status changes to failed.

## Widget completed (Awaiting verification)

 - [POST verify-envelope-widget](https://developers.signable.app/openapi/webhook-events/receiveverifyenvelopewidgetwebhook.md): This webhook is triggered when a recipient signs an envelope via the widget, but has not yet verified. It includes contact and document details.

## Widget signature verified

 - [POST verified-envelope-widget](https://developers.signable.app/openapi/webhook-events/receiveverifiedenvelopewidgetwebhook.md): This webhook is triggered when a recipient verifies their signed envelope through the verification email.  It includes details about the contact, documents, and verification.

## Template added

 - [POST add-template](https://developers.signable.app/openapi/webhook-events/receiveaddtemplatewebhook.md): This webhook is triggered when a new template is added to the account. It includes basic information about the template, including its title and fingerprint.

## Contact added

 - [POST add-contact](https://developers.signable.app/openapi/webhook-events/receiveaddcontactwebhook.md): This webhook is triggered when a new contact is added to the account. It includes basic information about the contact and the company that added them.

## User added

 - [POST add-user](https://developers.signable.app/openapi/webhook-events/receiveadduserwebhook.md): This webhook is triggered when a new user is added to the account.  It includes identifying information about the user and their assigned role.

