Tool Search: Mailgun Message Log
When a message is sent from a Campus tool, the Sent Message Log displays the Mailgun API delivery status. The Mailgun Message Log in System Administration contains all messages sent by the district via the Mailgun API, including password reset emails, username reminders, and account security email confirmations. The event status, email recipient, subject of the email, and any errors that occurred are listed. The Mailgun Message Log in the Messenger module contains the same information but limits the messages displayed to those sent by the person accessing the tool in Infinite Campus.
The status that displays in the Sent Message Log is not the same as the Event status found in the Mailgun Message Log. For example, A message can have a status of 'Sent' in the Sent Message Log but an Event status of 'Failed' in the Mailgun Log. In this scenario, the message was delivered to the Mailgun API but failed to reach the recipient.
- This tool is only available to users with Mailgun enabled in their district.
- In line with Mailgun's restrictions and recommendations, the data in this tool is updated hourly.
- For information on setting up Mailgun within Campus, see the Email Settings article.
Mailgun Message Log
See the Mailgun Message Log Tool Rights article for information on available tool rights.
IMPORTANT:
Mailgun uses a suppression list as spam prevention, instead of sending limits. If an email bounces (usually due to an invalid email address), Mailgun adds that email address to the suppression list to prevent further attempts. To resolve this issue, users must correct the email address of the recipient and contact Campus Support. Only Campus Support is authorized to remove the email address from the suppression list so emails can begin being sent to the recipient again.
Review Mailgun Messages
By default, the message log contains all messages sent by the district on the current day (System Administration > Messenger > Mailgun Message Log) or all messages sent by you on the current day (Messenger > Mailgun Message Log). This list can be populated with messages outside of the current date by entering a date range at the top and selecting Find Messages. You can also filter messages by entering criteria in the fields below each column.
The data in this tool updates frequently to include messages from the current day. Recently sent messages will not display immediately.
Filtering Messages
For example, entering a Subject of 'Missing' filtered messages to only those with this text included in the email subject.
Filtering Messages Based on Subject
You can also filter messages based on the Event that occurred, such as a failed message send. In the example below, messages are filtered by an Event of 'failed' and the Reason column describes why the message failed to send.
Reviewing Failed Messages
Invalid emails can be updated by conducting a 'Person ID' search using the All People, Advanced Search tool.
Recipient PersonID Advanced Search
Event statuses are defined as follows:
- Accepted - Mailgun accepted the request to send/forward the email, and the message has been placed in the queue.
- Rejected - Mailgun rejected the request to send/forward the email. Review the Reason column for why this may have occurred.
- Delivered - Mailgun sent the email, and it was accepted by the recipient's email server.
- Failed - Mailgun could not deliver the email to the recipient's email server. Review the Reason column for why this may have occurred.
- Complained - The email recipient clicked on the spam complaint button within their email client. This may impact your ability to reach this person in the future.
Generate the Mailgun Event Status Report
- In the Mailgun dashboard, navigate to the Created Between date fields.
- Enter your desired date range.
- Click Find Messages to filter the results.
- Click Generate Report.
- The report opens in a separate browser window as a CSV file.
Generating the Mailgun Message Log Report
Example Mailgun Event Status Report
Example of a Mailgun Event Status Report
