Delivery Events
Detailed reports can be downloaded from the Enterprise panel about 2 hours after a campaign runs. For real-time updates, Gupshup pushes events to your webhook.
Event types
| Event | Meaning |
|---|---|
DELIVERED | Email was delivered; the recipient has not acted on it yet. |
OPENED | Recipient opened the email. |
CLICKED | Recipient clicked a click-tracked link in the email. |
UNSUBSCRIBE | Recipient unsubscribed from your emails. |
SPAM REPORTS | Recipient marked the email as spam and their mail server reported it. |
NOT SENT | Gupshup dropped the message to protect your sender reputation, because the address is on your bounce, spam-report or unsubscribe list. |
NOT DELIVERED | The email bounced or was blocked (see below). |
DEFERRED | The receiving server temporarily limited access. Gupshup keeps retrying (see below). |
RESPONSE_AWAITED | Gupshup processed the request but has not yet received a delivery event from the recipient server. |
Bounces
A bounce is an email rejected by the receiving mail server.
Soft bounce — a temporary rejection, for example:
- The recipient's mailbox is full
- The mail server is temporarily unavailable
- The recipient closed their account while the email was being sent
Hard bounce — a permanent rejection, for example:
- Invalid address (typo, or the domain does not exist)
- The address does not exist
- The recipient's server has blocked the sending server
Soft bounces can become hard bouncesIf an address soft-bounces and three successive campaigns are undelivered to it, it is marked as a hard bounce.
Deferrals
A deferral means the receiving server is temporarily limiting access or busy — common causes are too many spam complaints on mail you've already sent, or technical issues at the inbox provider. It does not mean the email won't be delivered, only that delivery is delayed.
Gupshup retries deferred emails for up to 72 hours. If the email is accepted in that window you receive a delivery event; if it is still deferred after 72 hours, it becomes a block.
Updated about 12 hours ago