Webhooks

Webhooks allow smtp2go to notify your own web service whenever an event happens in your SMTP2GO account. For example, you can choose for your own server to be instantly notified whenever a bounce occurs.

Setup of webhooks can be done on the "Settings > Webhooks" page in your SMTP2GO control panel. Full instructions of the required set up, URI formats, securing a URL and testing can be found in our support article.

Standard Reported Data

The listed URL will receive an HTTP (or HTTPS) post request with the following parameters:

event: "processed", "delivered", "open", "click", "bounce", "spam", "unsubscribe", "resubscribe", or "reject".

time: UTC timestamp of when the event happened.
sendtime: UTC timestamp of when the email was sent to our server.
sender: the 'envelope-from' email address.
from: the email address the email was sent from.
rcpt: the email address the email was addressed to.
recipients: the email addresses the email was sent to.
auth: the SMTP Username, API Key or IP Address used to send the email.
host: the recipient server that bounced the message (bounce only).
message: the error message (where available).
context: contains additional information on the event (where available).
email_id: an identifier that uniquely identifies the email, which can be used to retrieve further details of the email delivery.
bounce: this parameter will be included for a bounce event, and will be either hard or soft, depending on how we classify the bounce type.
subject: the subject of the email.
user-agent: the "User-Agent" header of the device that opened the email (where applicable).
read-secs: the number of seconds an email was open - in five second increments up to a maximum of 30 (where applicable).
client: the reported client that clicked/opened the link ( based on the User-Agent ).
client-device: the reported device type of the User-Agent associated with the open/click event (where available)
client-os: the reported device operating system of the User-Agent associated with the open/click event (where available)
geoip-continent: a 2 character continent code based on a geoip lookup of the IP address associated with the open/click event (where available)
geoip-country: a 2 character country code based on a geoip lookup of the IP address associated with the open/click event (where available)
geoip-city: the name of the city based on a geoip lookup of the IP address associated with the open/click event (where available)
srchost: the IP address of the end-user associated with an open/click event (where available) or the IP address that submitted the email ( for processed events )