After an email leaves Vlozi, the email provider sends delivery feedback back in real time. Vlozi captures these events and uses them to update send status, power newsletter analytics, and automatically suppress future emails to addresses that bounce or complain.
Event types
| Event | Meaning |
|---|---|
email.sent |
Provider accepted the email for delivery |
email.delivered |
Email successfully delivered to the recipient's inbox |
email.opened |
Recipient opened the email (pixel-tracked) |
email.clicked |
Recipient clicked a link in the email |
email.bounced |
Email could not be delivered (hard or soft bounce) |
email.complained |
Recipient marked the email as spam |
Events are stored in the delivery event log and linked to the original send log by provider message ID.
How events update send status
When a delivery event arrives, Vlozi updates the corresponding send log:
| Event | New send status |
|---|---|
email.delivered |
delivered |
email.bounced |
failed |
| Others | No status change (events are logged but status stays sent) |
Newsletter integration
Delivery events automatically flow into newsletter analytics when the email was sent as part of a campaign:
| Event | Effect on newsletter |
|---|---|
email.delivered |
Increments campaign delivery count |
email.opened |
Increments campaign open count |
email.clicked |
Increments campaign click count |
email.bounced (hard) |
Increments bounce count; suppresses subscriber from all future sends |
email.complained |
Increments complaint count; suppresses subscriber from all future sends |
Hard bounces and complaints result in the subscriber being permanently suppressed. They will not receive future campaigns or transactional emails from your account until manually re-enabled.
Bounce handling
A hard bounce means the email address is permanently invalid (e.g., user doesn't exist, domain doesn't exist). Vlozi automatically:
- Marks the send log as
failed - Records the bounce reason
- Suppresses the subscriber in Newsletter so future campaigns don't attempt delivery
A soft bounce (mailbox full, server temporarily unavailable) is logged as an event but does not suppress the subscriber.
Viewing delivery events
Delivery event details are visible in the email send logs. In the dashboard, click any send log row to see associated events with timestamps.
Events are also accessible via the API:
GET /comms/v1/logs
x-tenant-id: {your-tenant-id}The send log's status field reflects the most recent delivery outcome.
Webhook security
Vlozi verifies all incoming delivery webhooks from the email provider using HMAC-SHA256 (Svix). Webhooks without a valid signature are rejected with a 401. You don't need to configure or verify anything — this happens automatically on Vlozi's end.
If you're building a custom integration and need to receive raw delivery events, contact support for webhook forwarding options.