Skip to main content
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

EventWhen it fires
sender.createdA sender was created and the verification email was sent
sender.verifiedThe address owner completed email verification
sender.failedVerification failed due to a bounce or error
sender.deletedA 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.
JSON
{
    "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"
    }
}

​
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.
JSON
{
    "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"
    }
}

​
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.
JSON
{
    "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"
    }
}

​
sender.deleted

Fires when a sender is deleted from the account. SignatureAPI can no longer send signing requests on behalf of this address.
JSON
{
    "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"
    }
}