Working out why an email or text did not arrive
Find the reason a message to a candidate failed, using the Communications tab, the Audit Log and the daily delivery issues email.
Find the reason a message to a candidate failed, using the Communications tab, the Audit Log and the daily delivery issues email.
This is for recruiters, System Admin and HR users who send email and texts to candidates. The Audit Log checks in the last section need the Admin role.
Why an email or text can fail to reach someone
- Hard bounce. The receiving server refused the email for good. The address is added to the suppression list and no further emails are sent to it. Managing blocked email addresses in Email Suppressions explains how to check and lift it.
- Soft bounce. A temporary problem, such as a full mailbox. Nothing is blocked, and later emails are still sent.
- Spam complaint. The recipient marked an email as spam. Recruit unsubscribes that address from all email other than the essential system emails. This is recorded as an unsubscribe, not as a suppression, so it does not appear in the suppression list.
- Unsubscribe. The recipient used the unsubscribe link in an email. Email of that type, or all email other than the essential system emails if the unsubscribe was global, is no longer sent to them.
- SMS opt out. The recipient replied STOP to a text. Recruit adds "Reply STOP to opt out." to outgoing texts and stops texting that number.
- No agreement to texts. Texts only go to a number the candidate has agreed to. They agree by ticking the optional text message box on the application form (covers every text) or by typing the number on the interview booking page (covers booking confirmations and the 24 hour and 1 hour reminders only).
What recruiters and candidates see
Sending from a candidate's profile
If you send an email from a candidate's profile and their address is blocked or unsubscribed, a red message reads Email not delivered: "Nothing was sent to [name], their address is unsubscribed or blocked, or the send was rejected." Nothing reaches the candidate.
In a bulk email, candidates with a blocked address are left out and listed as excluded, and the rest are sent as normal. If the whole request is refused, the dialog reads "The send was rejected, so nothing was sent. Check the message and options, then try again." Correct the message or options and send again.
The Communications tab
Every email and text is recorded on the candidate's Communications tab with one of these statuses: Queued, Scheduled, Sending, Sent, Cancelled, Failed or Bounced.
Failed means Recruit did not deliver the message. Hover over the status to see the reason. Opening the row shows the same text under Reason. A spam complaint also moves an email to Failed. Bounced means the email was sent but the receiving server sent it back later. Both hard and soft bounces set this status.
| Reason shown | What it means and what to do |
|---|---|
| Recipient address is suppressed (bounced or complained) | The address bounced permanently or the candidate complained. Check the address under Email Suppressions. |
| Recipient had unsubscribed | The candidate opted out. Contact them another way. |
| Sending limit reached | Too many messages were sent in a short time. |
| The provider rejected the send | The provider refused the message. |
| No template or content was configured | The message had no template or text. |
| Not sent, followed by field names | A required template field had no value for this candidate. |
| Not sent because the candidate has no valid email address | There is no usable address on the record. See Candidates with no valid email address. |
| Recipient replied STOP to text messages | The candidate opted out of texts. |
| Not sent because the candidate has not agreed to texts at this number | No tick box or booking page number from the candidate. |
| The phone number is not a valid mobile number | Correct the number on the candidate record. |
| Text messaging is not enabled for this account | Texts are a paid add on that is not switched on for your organisation. |
| Not sent because this account is not live yet | Messages are not sent until your organisation has gone live. |
Failed and Bounced emails have a Resend button. It opens a box with the Recipient address filled in, which you can correct before selecting Resend. If the corrected send succeeds, Recruit also updates the stored email address for that person. Resending to an address that is still suppressed or unsubscribed fails again.
Offers
Offer emails are treated like any other email. If the candidate's address is suppressed or unsubscribed, the offer is still marked as sent, but the offer email is not delivered. The Communications tab shows a Failed email with the reason. Check it after sending an offer to a candidate whose address has caused problems, and contact them another way if it failed.
Text messages
Once a candidate replies STOP, texts to that number are not sent. They appear as failed on the Communications tab, and in the Audit Log under SMS Activity the number carries an Opted out label. If you send a text to a candidate who has not agreed to texts at this number, you see "The candidate has not agreed to texts at this number. They can give it on the interview booking page."
A text that the mobile carrier could not deliver moves from Sent to Failed, and the Last carrier event column in SMS Activity shows what the carrier reported.
Working out why a message did not arrive
- Open the candidate and go to the Communications tab. Find the message and read its status.
- If it is Failed, hover over the status for the reason and use the table above.
- If it is Bounced, look the address up under both tabs of Settings > Email Suppressions. A hard bounce appears on the Blocked tab and a soft bounce on the Temporary bounces tab.
- If the status is Sent but the candidate says nothing came, a System Admin can use the Email Activity tab of the Audit Log. Checking sent emails and texts in the audit log has the steps.
The daily delivery issues email
Each day, if any emails or texts failed or were not sent in the previous 24 hours, Recruit emails every active System Admin a list of them. The subject is "Email and text delivery issues in the last 24h". For each item it shows who it was for, the job and its reference, the application reference, the time and the reason. If scheduled reminders ran late, the email adds a section called Delayed scheduled reminders. When the only problem is late reminders, the email is titled "Some scheduled reminders were delayed".
Details of candidates you are not permitted to see, such as an agency candidate who has not been revealed to you, are hidden.
The email is on by default. A System Admin can turn it off under Settings > Notifications > Configure defaults, using the Send admins a daily email about delivery issues switch under Email and text delivery issues digest. The switch changes only this email. Other notifications are unaffected.