Webhooks

As of v1.1.1.0, if Webhooks are specified at Settings - Webhooks, the mail server will be sending a XML request to the URLs specified. Up to three URLs are allowed. The consuming server must return a reply with plain/txt content type, which will be displayed in the mail server log, if Webhook logging is enabled.

The sample XML request is below:

        <WebhookRequest>
           <EventDateTime>2019-02-18T18:51:02.9863129Z</EventDateTime>
           <Event>smtp.relay</Event>
           <Id>888</Id>
           <Status>fail</Status>
           <Info>Appears to be a spam. Rejecting...</Info>
           <MailFrom>sender@email.com</MailFrom>
           <RcptTo>recipient@email.com</RcptTo>
           <Headers>
             Received: from 04772959.email.com ([127.0.0.1]:19787 helo=someone.com) by voithmuml.jvitale.icu with ESMTP id 04ATVXC7729DBTOW59;
                 for <recipient@email.com>; Mon, 18 Feb 2019 10:51:00 -0800
             To: <recipient.email.com>
             Message-ID: <147873387490344614787538711901369723230@voithmuml.jvitale.icu>
             Date: Mon, 18 Feb 2019 10:51:00 -0800
             From: "John Doe" <sender@email.com>
             Subject: Stop Running in Circles
             Content-Language: en-us
             MIME-Version: 1.0
             Content-Transfer-Encoding: 8bit
             Content-Type: multipart/alternative; boundary="----=Part.986.173.1550515860"
           </Headers>
       </WebhookRequest>
    

Following events are defined, and can be enabled or disabled on the Mail Server UI:

Following field values are provided, depending on the request type:

Field Description Applicable events
EventDateTime Date and Time the event has occured All
Event Name of Event All
Id Connection ID. Matches an ID in the mail server log All, except server.start and server.stop
Status success, fail or error All
Info Additiona information about the event status All
HeloParameter Parameter transmitted with SMTP HELO/EHLO command by connecting MTA smtp.relay
IpAddress IP address of connecting MTA All except server.start and server.stop
AuthUser Name of authenticated user, if applicable and known All except server.start and server.stop
MailFrom Address transmitted with MAIL FROM command smtp.relay
RcptTo Comma separated list of addresses transmitted with RCPT TO command smtp.relay
Headers Headers of message smtp.relay
Data Body of message, if enabled on the mail server UI smtp.relay