> ## Documentation Index
> Fetch the complete documentation index at: https://signatureapi-daf4ee54.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Email Notifications

Notification channels let you receive email updates about envelope and recipient activity in your account.

When events occur (such as an envelope completing or a recipient bouncing), SignatureAPI sends a notification to each active channel.

## Adding a notification channel

<Steps>
  <Step title="Go to Settings">
    In the Dashboard, navigate to **[Settings > Notifications](https://dashboard.signatureapi.com/settings/notifications)**.

    <Frame>
      <img src="https://mintcdn.com/signatureapi-daf4ee54/LH12A5G3JgDiqHXh/docs/dashboard/images/add-notification-channel-step-1.png?fit=max&auto=format&n=LH12A5G3JgDiqHXh&q=85&s=6803dc5363e01b745906b4709c38d925" alt="Navigate to Settings > Notifications" data-og-width="2880" width="2880" data-og-height="1702" height="1702" data-path="docs/dashboard/images/add-notification-channel-step-1.png" data-optimize="true" data-opv="3" srcset="https://mintcdn.com/signatureapi-daf4ee54/LH12A5G3JgDiqHXh/docs/dashboard/images/add-notification-channel-step-1.png?w=280&fit=max&auto=format&n=LH12A5G3JgDiqHXh&q=85&s=fd78a6f3db68e572ce7b0e4c792f3d70 280w, https://mintcdn.com/signatureapi-daf4ee54/LH12A5G3JgDiqHXh/docs/dashboard/images/add-notification-channel-step-1.png?w=560&fit=max&auto=format&n=LH12A5G3JgDiqHXh&q=85&s=9e3be113a81f947eeed4d4ca303483b6 560w, https://mintcdn.com/signatureapi-daf4ee54/LH12A5G3JgDiqHXh/docs/dashboard/images/add-notification-channel-step-1.png?w=840&fit=max&auto=format&n=LH12A5G3JgDiqHXh&q=85&s=8746be63eb67c4a2a16d73633f619cdb 840w, https://mintcdn.com/signatureapi-daf4ee54/LH12A5G3JgDiqHXh/docs/dashboard/images/add-notification-channel-step-1.png?w=1100&fit=max&auto=format&n=LH12A5G3JgDiqHXh&q=85&s=376b424acf18344e06d4d1f9c6d183e4 1100w, https://mintcdn.com/signatureapi-daf4ee54/LH12A5G3JgDiqHXh/docs/dashboard/images/add-notification-channel-step-1.png?w=1650&fit=max&auto=format&n=LH12A5G3JgDiqHXh&q=85&s=5b5b1ec7bcafa1c064884c9070356ec6 1650w, https://mintcdn.com/signatureapi-daf4ee54/LH12A5G3JgDiqHXh/docs/dashboard/images/add-notification-channel-step-1.png?w=2500&fit=max&auto=format&n=LH12A5G3JgDiqHXh&q=85&s=125fede87dc5b1d6abaee82df28a2261 2500w" />
    </Frame>
  </Step>

  <Step title="Add an email address">
    Click **New Notification Email** and enter the email address where you want to receive notifications.

    <Frame>
      <img src="https://mintcdn.com/signatureapi-daf4ee54/LH12A5G3JgDiqHXh/docs/dashboard/images/add-notification-channel-step-2.png?fit=max&auto=format&n=LH12A5G3JgDiqHXh&q=85&s=cadf3fc77930fb66d26809d7052edf41" alt="Click New Notification Email" width="2880" height="1702" data-path="docs/dashboard/images/add-notification-channel-step-2.png" />
    </Frame>
  </Step>

  <Step title="Verify the email">
    A verification email is sent to the address. Click the confirmation link to activate the channel.

    <Frame>
      <img src="https://mintcdn.com/signatureapi-daf4ee54/bSUOYkw8QLI_pP3t/docs/dashboard/images/add-notification-channel-step-3.png?fit=max&auto=format&n=bSUOYkw8QLI_pP3t&q=85&s=df0cd037ff86dca6cb70c38d4f29cf4c" alt="Verify the email address" width="703" height="693" data-path="docs/dashboard/images/add-notification-channel-step-3.png" />
    </Frame>
  </Step>
</Steps>

<Note>You need the **Manage Notifications Settings** permission to add or remove notification channels.</Note>

## Stop Receiving Notifications

To delete a notification channel, go to **[Settings > Notifications](https://dashboard.signatureapi.com/settings/notifications)**, select the channel you want to remove, and delete it from the channel details page. Deleting a channel is permanent. The email address will stop receiving all notifications immediately, and you will need to re-add and re-verify it if you want to receive notifications at that address again.

<Frame>
  <img src="https://mintcdn.com/signatureapi-daf4ee54/bSUOYkw8QLI_pP3t/docs/dashboard/images/notification-channel-detail.png?fit=max&auto=format&n=bSUOYkw8QLI_pP3t&q=85&s=62feeba3f20e1c9888a72927993de973" alt="Notification channel details" width="2880" height="1702" data-path="docs/dashboard/images/notification-channel-detail.png" />
</Frame>

## Channel statuses

| Status               | Description                                                                  |
| :------------------- | :--------------------------------------------------------------------------- |
| Pending Verification | A verification email has been sent. Click the link in the email to activate. |
| Active               | The channel is verified and receiving notifications.                         |

## Notification events

Active channels receive notifications for the following events:

### Envelope events

| Event              | Description                                 |
| :----------------- | :------------------------------------------ |
| Envelope completed | All recipients have completed the envelope. |
| Envelope canceled  | The envelope was canceled.                  |
| Envelope failed    | The envelope has failed.                    |

### Recipient events

| Event               | Description                                               |
| :------------------ | :-------------------------------------------------------- |
| Recipient completed | The recipient completed the ceremony.                     |
| Recipient rejected  | The recipient rejected the envelope.                      |
| Recipient bounced   | The email to the recipient bounced (soft or hard bounce). |
| Recipient failed    | The recipient's process failed.                           |

## Notification channels vs webhooks

Notification channels send human-readable emails for monitoring purposes. For programmatic event handling, use [webhooks](/docs/api/webhooks) instead.
