Skip to main content
The LCEmailStats event fires for each email delivery event processed through the LC Email provider. This webhook is available exclusively to Location Level Apps. Each payload carries delivery status details, SMTP response codes, envelope routing information, and recipient data. Use this event to track deliverability metrics, build real-time email dashboards, or trigger re-send logic when delivery failures occur.

Payload

FieldTypeDescription
eventstringDelivery event type, e.g. "delivered", "bounced", "complained"
recipientstringEmail address of the message recipient
domainstringSending domain used for this message
message-headersarrayRaw email headers from the message
Message-IdstringUnique message identifier in RFC 5322 format
timestampnumberUnix timestamp of when the event occurred
tokenstringWebhook authentication token for verifying the request
signaturestringHMAC signature for validating webhook authenticity
delivery-statusobjectDetailed delivery outcome information
delivery-status.tlsbooleanWhether the message was delivered over a TLS-encrypted connection
delivery-status.mx-hoststringMX host that accepted the message
delivery-status.attempt-nonumberDelivery attempt number (increments on retries)
delivery-status.descriptionstringHuman-readable description of the delivery status
delivery-status.session-secondsnumberDuration of the SMTP session in seconds
delivery-status.utf8booleanWhether UTF-8 encoding was used during the SMTP session
delivery-status.codenumberSMTP response code returned by the receiving server
delivery-status.messagestringSMTP response message returned by the receiving server
delivery-status.certificate-verifiedbooleanWhether the receiving server’s TLS certificate was verified
envelopeobjectRouting and transport information for the message
envelope.transportstringTransport protocol used, e.g. "smtp"
envelope.senderstringFrom address used in the SMTP envelope
envelope.sending-ipstringIP address from which the message was sent
envelope.targetsstringRecipient address(es) in the SMTP envelope
flagsobjectAdditional flags returned by the email provider

Example payload

{
  "event": "delivered",
  "recipient": "contact@example.com",
  "domain": "example.com",
  "Message-Id": "<20231212.09:27:42@example.com>",
  "timestamp": 1702376862,
  "delivery-status": {
    "tls": true,
    "mx-host": "mx.example.com",
    "attempt-no": 1,
    "description": "",
    "session-seconds": 0.087,
    "code": 250,
    "message": "OK",
    "certificate-verified": true
  },
  "envelope": {
    "transport": "smtp",
    "sender": "noreply@hoopai.com",
    "sending-ip": "123.45.67.89",
    "targets": "contact@example.com"
  }
}
  • Emails API — send and manage emails through the HoopAI platform
Last modified on March 4, 2026