Skip to main content
Sender events track the verification process for email addresses used as senders in envelopes. This page describes each sender event type, when it occurs, and the additional data included in the event payload.

​
sender.created

The sender.created event is triggered when a sender verification request is created for an envelope.
JSON
{
    "id": "evt_1a2b3c4d5e6f7g8h9i0j",
    "type": "sender.created",
    "timestamp": "2025-12-31T23:59:59.999Z",
    "data": {
        "object_id": "sen_00ZeZjRaXCgT30n1eBx53N",
        "object_type": "sender",
        "email": "sender@example.com"
    }
}

​
sender.verified

The sender.verified event is triggered when a sender verification request is completed successfully.
JSON
{
    "id": "evt_2b3c4d5e6f7g8h9i0j1k",
    "type": "sender.verified",
    "timestamp": "2025-12-31T23:59:59.999Z",
    "data": {
        "object_id": "sen_00ZeZjRaXCgT30n1eBx53N",
        "object_type": "sender",
        "email": "sender@example.com"
    }
}

​
sender.failed

The sender.failed event is triggered when a sender verification fails. This can be due to a soft or hard bounce of the verification request email, or because of an internal error. The event data includes a detail property with more information about the failure.
JSON
{
    "id": "evt_3c4d5e6f7g8h9i0j1k2l",
    "type": "sender.failed",
    "timestamp": "2025-12-31T23:59:59.999Z",
    "data": {
        "object_id": "sen_00ZeZjRaXCgT30n1eBx53N",
        "object_type": "sender",
        "email": "sender@example.com",
        "detail": "Verification email could not be delivered."
    }
}

​
sender.deleted

The sender.deleted event is triggered when a sender is deleted from an envelope. The event data includes an email property with the sender’s email address.
JSON
{
    "id": "evt_4d5e6f7g8h9i0j1k2l3m",
    "type": "sender.deleted",
    "timestamp": "2025-12-31T23:59:59.999Z",
    "data": {
        "object_id": "sen_00ZeZjRaXCgT30n1eBx53N",
        "object_type": "sender",
        "email": "sender@example.com"
    }
}