# Webhooks

Receive real-time notifications about document events.

## List webhooks

 - [GET /webhooks](https://signable-developer-portal.redocly.app/openapi/webhooks/listwebhooks.md): Retrieves a paginated list of all webhooks currently registered to receive event notifications. Supports offset and limit for pagination. Webhooks include metadata about creation, update, and suspension state.


## Create a webhook

 - [POST /webhooks](https://signable-developer-portal.redocly.app/openapi/webhooks/createwebhook.md): Registers a new webhook that will be triggered when a specific event occurs. You must provide a valid  and a supported . The created webhook will immediately be eligible to receive matching notifications.


## Get a webhook

 - [GET /webhooks/{webhook_id}](https://signable-developer-portal.redocly.app/openapi/webhooks/getwebhook.md): Retrieves details of a specific webhook by its unique . The response includes the current status and metadata of the webhook.


## Update a webhook

 - [PUT /webhooks/{webhook_id}](https://signable-developer-portal.redocly.app/openapi/webhooks/updatewebhook.md): Updates the webhook identified by . You may change the and/or the .


## Delete a webhook

 - [DELETE /webhooks/{webhook_id}](https://signable-developer-portal.redocly.app/openapi/webhooks/deletewebhook.md): Deletes the webhook identified by . Once removed, the webhook will no longer receive event notifications.


## Envelope sent

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


## Envelope signed

 - [POST signed-envelope](https://signable-developer-portal.redocly.app/openapi/webhooks/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://signable-developer-portal.redocly.app/openapi/webhooks/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 signed & complete

 - [POST signed-envelope-complete](https://signable-developer-portal.redocly.app/openapi/webhooks/receivesignedenvelopecompletewebhook.md): This webhook is triggered when all required parties have completed signing an envelope. It includes the envelope fingerprint, documents, any captured field data, and a download link.


## Envelope rejected

 - [POST rejected-envelope](https://signable-developer-portal.redocly.app/openapi/webhooks/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://signable-developer-portal.redocly.app/openapi/webhooks/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://signable-developer-portal.redocly.app/openapi/webhooks/receivebouncedenvelopewebhook.md): Triggered when an email to a signer fails to deliver.


## Widget completed (Awaiting verification)

 - [POST verify-envelope-widget](https://signable-developer-portal.redocly.app/openapi/webhooks/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://signable-developer-portal.redocly.app/openapi/webhooks/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://signable-developer-portal.redocly.app/openapi/webhooks/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://signable-developer-portal.redocly.app/openapi/webhooks/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://signable-developer-portal.redocly.app/openapi/webhooks/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.