Troubleshooting emails (pre release feature guide)
This guide is for a new feature, currently being trialled. See our parent report guides for the current functionality.
On occasion, parent report emails may fail to be delivered. This guide details the various scenarios and suggestions on next steps to resolve.
Email bounce codes
When an email fails to be delivered, a 'bounce code' may be returned by the mail system associated with the email address. These codes represent messages from a mail server to indicate why an email you sent was not delivered. Insight will display this code, and it may help you decide any next steps. There is no guarantee that a code will be returned, so it is possible that an email fails, but Insight is unable to state that it has failed, or why.
Navigate to Reports > Parent Reports and choose the term and template you're interested in.
When Insight receives a bounce code, this will be indicated with the word Failed.

The total % failed is shown against the Email column header. Clicking the indicator will automatically apply a status filter of Failed to allow you to quickly see all failed emails together.

It is also indicated against each individual email.
Click Failed to see more information.

Only Admin users will see the email address.
The Type will be one of the following:
Transient - This is known as a Soft Bounce and may indicate a temporary problem. Insight will continue to attempt to send the email, but if the error continues, it may require a manual resend or other action.
Permanent - This is known as a Hard Bounce and indicates a failure that is not likely to be resolved with a Resend.
The Status code is additional and may provide further detail on the reason for the failure. Not all mail servers provide these codes.
What can I do to resolve a failure?
When an email fails, this is usually at the recipient's end. The email has been sent but has not arrived, or been accepted, at the destination.
The most likely issue is that the email address is mistyped or does not exist. You should check with the recipient that the email address they provided is correct and amend it if necessary.
If you're syncing emails from your MIS, remember to amend it there too, or the incorrect email will return on the next sync.
If the recipient confirms that the email is correct, it may be worth double-checking. Can they receive a standard email sent to them, for example?
The Status code may provide other useful information. The codes and their descriptions are provided at the end of this guide.
If you are unable to resolve the failure, it may be worth checking if the recipient has an alternative email address you could use.
If all else fails, you may need to print the report for delivery.
Email status codes
These codes are externally defined. As such, Insight can display the codes, but we are unable to provide any further support on their diagnosis.
Code | Explanation |
5.0.0 | Address does not exist |
5.1.0 | Other address status |
5.1.1 | Bad destination mailbox address |
5.1.2 | Bad destination system address |
5.1.3 | Bad destination mailbox address syntax |
5.1.4 | Destination mailbox address ambiguous |
5.1.5 | Destination mailbox address valid |
5.1.6 | Mailbox has moved |
5.1.7 | Bad sender’s mailbox address syntax |
5.1.8 | Bad sender’s system address |
5.2.0 | Other or undefined mailbox status |
5.2.1 | Mailbox disabled, not accepting messages |
5.2.2 | Mailbox full |
5.2.3 | Message length exceeds administrative limit. |
5.2.4 | Mailing list expansion problem |
5.3.0 | Other or undefined mail system status |
5.3.1 | Mail system full |
5.3.2 | System not accepting network messages |
5.3.3 | System not capable of selected features |
5.3.4 | Message too big for system |
5.4.0 | Other or undefined network or routing status |
5.4.1 | No answer from host |
5.4.2 | Bad connection |
5.4.3 | Routing server failure |
5.4.4 | Unable to route |
5.4.5 | Network congestion |
5.4.6 | Routing loop detected |
5.4.7 | Delivery time expired |
5.5.0 | Other or undefined protocol status |
5.5.1 | Invalid command |
5.5.2 | Syntax error |
5.5.3 | Too many recipients |
5.5.4 | Invalid command arguments |
5.5.5 | Wrong protocol version |
5.6.0 | Other or undefined media error |
5.6.1 | Media not supported |
5.6.2 | Conversion required and prohibited |
5.6.3 | Conversion required but not supported |
5.6.4 | Conversion with loss performed |
5.6.5 | Conversion failed |
5.7.0 | Other or undefined security status |
5.7.1 | Delivery not authorized, message refused |
5.7.2 | Mailing list expansion prohibited |
5.7.3 | Security conversion required but not possible |
5.7.4 | Security features not supported |
5.7.5 | Cryptographic failure |
5.7.6 | Cryptographic algorithm not supported |
5.7.7 | Message integrity failure |