Sender events – SignatureAPI Docs

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.

Example event payload

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.

Example event payload

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.

Example event payload

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.

Example event payload

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"
    }
}