Email History contains information about emails that have been processed by the mail server for sending. Each row represents an individual message and records information related to the sender, recipient, delivery status, and technical details of the sending process.Simply put, this collection allows you to know which emails have left the server, whether they have been delivered correctly, and what happened during the delivery process.
Email History serves to analyze email sending activity.It allows you to investigate delivery incidents, verify that messages have arrived correctly to their recipients, and detect possible problems in email configuration or reputation.
For example, this collection allows you to:
If you want to know what happened with a sent email or investigate delivery problems, the appropriate collection is Email History.
| Field | Type | Description |
|---|---|---|
| delivered_at | Date and time | Date and time when the email delivery was attempted in UTC timezone. |
| dsn | Categorical | Delivery status code. Codes 2.x.x indicate successful delivery, 4.x.x temporary failure (active retries), and 5.x.x permanent failure. |
| message_id | Categorical | Unique identifier of the email. |
| queue_id | Categorical | Identifier of the sending process on the mail server. |
| reason | Categorical | Response from the destination server indicating confirmation or rejection reason. |
| recipient | Categorical | Recipient's email address. |
| relay | Categorical | Remote server used for delivery (domain, IP, and port). |
| remote_host | Categorical | Destination server that processed the email. |
| sasl_user | Categorical | Authenticated user who made the sending. |
| sender | Categorical | Sender's email address. |
| status | Categorical | Sending status: sent, deferred, bounced, or expired. |
Identifies the client or system that initiated the sending of the message.
It normally contains information about the origin of the connection that generated the email.
It can be useful to identify where a specific sending originated.
Indicates the date and time when the delivery result of the message was recorded.
It allows you to reconstruct chronologically the sending activity and analyze incidents in specific periods.
Data type: categorical text
Corresponds to the DSN (Delivery Status Notification) code.
These codes are standards used by mail servers to indicate the result of a delivery.
They help classify whether a message was delivered correctly or if an error occurred.
Unique identifier associated with the email message.
It allows you to locate a specific email and relate different events associated with the same sending.
It is one of the most useful fields for detailed investigations.
Internal identifier used by the mail server during message processing.
It is useful for support tasks and technical investigation.
Data type: categorical text
Describes the reason associated with the delivery result.
When there is an error, this field usually contains relevant information about the cause of the problem.
It is one of the most important fields for diagnosing email incidents.
Data type: categorical text
Indicates the recipient's email address of the message.
It allows you to identify who was supposed to receive the email and analyze incidents associated with specific recipients.
Data type: categorical text
Indicates the remote server responsible for receiving or processing the email.
It is useful for analyzing the message's journey and detecting problems associated with specific servers.
Data type: categorical text
Identifies the remote host involved in the delivery process.
It can be used to investigate incidents related to specific destination servers.
Data type: categorical text
Indicates the authenticated user who made the message sending.
This field allows you to know which email account actually originated the sending.
It is especially useful for audits and activity analysis.
Data type: categorical text
Indicates the sender's email address.
It allows you to identify from which account the message was sent.
Data type: categorical text
Indicates the final result of the delivery process.
Some common examples are:
This field allows you to quickly identify if the email was delivered correctly or if any problem occurred.
status field to check what happened.status, reason, and dsn fields to identify the exact cause of the problem.sasl_user or sender to detect accounts with unusual sending volumes.recipient, relay, and remote_host fields to detect error patterns associated with specific servers.