> ## 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.

# Sender events

> Track sender email verification lifecycle events including creation, verification, failure, and deletion

Sender events track the lifecycle of email address verification for senders. Each event includes a `data` object with the sender's `object_id` and `email`.

## Event types

| Event             | When it fires                                            |
| ----------------- | -------------------------------------------------------- |
| `sender.created`  | A sender was created and the verification email was sent |
| `sender.verified` | The address owner completed email verification           |
| `sender.failed`   | Verification failed due to a bounce or error             |
| `sender.deleted`  | A sender was deleted from the account                    |

***

## sender.created

Fires when a new sender is created and the verification email is sent. The sender starts in `pending_verification` status. Listen for `sender.verified` or `sender.failed` to track the verification outcome.

<Accordion title="Example event payload">
  ```json JSON theme={null}
  {
      "id": "evt_yA80uuM4c90EbmxFuOC8Xv5",
      "type": "sender.created",
      "timestamp": "2025-01-01T00:00:00.000Z",
      "data": {
          "object_type": "sender",
          "object_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
          "email": "jennifer@example.com"
      }
  }
  ```
</Accordion>

***

## sender.verified

Fires when a sender completes email verification. The sender status is now `verified`. SignatureAPI can send signing requests on behalf of this address.

<Accordion title="Example event payload">
  ```json JSON theme={null}
  {
      "id": "evt_yA80uuM4c90EbmxFuOC8Xv5",
      "type": "sender.verified",
      "timestamp": "2025-01-01T00:00:00.000Z",
      "data": {
          "object_type": "sender",
          "object_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
          "email": "jennifer@example.com"
      }
  }
  ```
</Accordion>

***

## sender.failed

Fires when sender email verification fails. This can happen due to a soft or hard bounce of the verification email, or an internal error. The `data.detail` property contains a human-readable explanation of the failure reason.

<Accordion title="Example event payload">
  ```json JSON theme={null}
  {
      "id": "evt_yA80uuM4c90EbmxFuOC8Xv5",
      "type": "sender.failed",
      "timestamp": "2025-01-01T00:00:00.000Z",
      "data": {
          "object_type": "sender",
          "object_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
          "email": "jennifer@example.com",
          "detail": "Verification email bounced"
      }
  }
  ```
</Accordion>

***

## sender.deleted

Fires when a sender is deleted from the account. SignatureAPI can no longer send signing requests on behalf of this address.

<Accordion title="Example event payload">
  ```json JSON theme={null}
  {
      "id": "evt_yA80uuM4c90EbmxFuOC8Xv5",
      "type": "sender.deleted",
      "timestamp": "2025-01-01T00:00:00.000Z",
      "data": {
          "object_type": "sender",
          "object_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
          "email": "jennifer@example.com"
      }
  }
  ```
</Accordion>