Webhook Structure

Supported Events

At present, the Netcore Email API provides webhook support for a variety of events, including:

EventDescription
SentMessage has been sent successfully
DroppedMessage got dropped
BouncedMessage has hard bounce
OpenedMessage got opened
ClickedRecipient clicked a link in the message; will only occur when click tracking is enabled
UnsubscribedRecipient Unsubscribed
InvalidSyntactically incorrect email IDs
Abuse/SpamRecipient marked the message as abuse/spam

Each webhhok request can have a maximum of 100 events in a single HTTP POST request.

If you require higher batch (maximum 1000) Please reachout to support team at [email protected]

The following glossary and sample data outline each event, providing the specific parameters that were delivered through the HTTP POST:

ParametersData TypeEvents where this is meaningful/usedDescription
TRANSIDInt64AllAll assigns a Unique Transaction ID for each and every email which were sent
EMAILStringAllRecipient’s Email ID
EVENTStringAllType of Event: sent/ dropped/ invalid/ bounced/ opened/ clicked/ unsubscribed/ spam
RESPONSEStringsent/ dropped/invalid/ bounceResponse received from the end server like Delivery Logs, Bounce reason, reason for drop(blacklisted user / already unsubscribed)
X-APIHEADERStringAllInformation passed by you in the X-APIHEADER, during the time of email sent
TIMESTAMPIntAllUnix Timestamp of the occurrence of the event
USERAGENTStringopened/ clicked/ unsubscribed/spamUser agent contains the detailed information about the browser from where a specific event in initiated.
IPADDRESSStringopened/ clicked/unsubscribed/spamIP address of the device from where the recipient has responded.