Mailgun Message Log

Tool Search: Mailgun Message Log

When a message is sent from a Campus tool, the Sent Message Log displays the status of the delivery of the message to the Mailgun API. The Mailgun Message Log found in System Administration contains all of the 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 found in the Messenger module contains all of the same information but limits the messages displayed to only those sent by the person accessing the tool within 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 in its delivery to the recipient. 

  • This tool is only available for users who have Mailgun functionality enabled in their district. 
  • Based on Mailgun restrictions and recommendation, the data in this tool is updated hourly.
  • For information on setting up Mailgun within Campus, see the Email Settings article. 

Screenshot of the mailgun message log.Mailgun Message Log

IMPORTANT:

Mailgun uses a suppression list as spam prevention, instead of sending limits. If an email message bounces (usually due to an invalid email address), Mailgun places that email address on 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 in order for emails to begin sending to the recipient again. 

Tool Rights

PATH: System Administration > User Security > Users > Tool Rights

Users must have at least R(ead) tool rights assigned for the Mailgun Message Log in order to access and view data. 

Screenshot of the mailgun message log tool rights.

Mailgun Message Log Tool Rights

Reviewing 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 current day messages. Recently sent messages will not display immediately.  

Screenshot of the filtering options.Filtering Messages

For example, entering a Subject of 'Missing' filtered messages to only those with this text included in the email subject.

Screenshot of the filtering options based on the subject.Filtering Messages Based on Subject

You can also filter messages based on the Event which occurred, such as a failure to send the message. In the example below, messages are filtered by an Event of 'failed' and the Reason column describes why the message failed to send.

Screenshot of reviewing failed messages.Reviewing Failed Messages

Invalid emails can be updated by conducting a 'Person ID' search using the All People, Advanced Search tool.

Screenshot of the recipient personID Advanced search option.Recipient PersonID Advanced Search

Event status are defined as the following:

  • 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 email server.
  • Failed - Mailgun could not deliver the email to the recipient 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 Report

You can generate a report of all messages sent through the Mailgun API during a specific date range by entering this date range in the Created Between date fields and clicking Generate Report at the bottom of the screen (Image 6).

Screenshot of generating the mailgun message log report.Generating the Mailgun Message Log Report

The report will appear in a separate window in CSV format. 

Screenshot of a mailgun report example.Example of Report