How email trigger tasks send
When an Email Trigger task sends its email, who receives it, and what to check when nothing arrives.
When an Email Trigger task sends its email, who receives it, and what to check when nothing arrives.
An Email Trigger task sends one email and needs nobody's attention. The new starter never sees the task. This is for System Admins and HR users who build onboarding templates and follow live onboardings. The task is added in the template builder, as described in "Choosing task types in an onboarding template".
Who receives the email
In the template you choose who it goes to under Send to.
- Candidate sends it to the new starter. This is the only choice where the portal link is filled in.
- Reporting manager sends it to whatever was typed in Reporting Manager (optional) when onboarding was started. That box must hold an email address. A name produces no email.
- Custom email address sends it to the address entered under Recipient email.
Under Email template pick one of your email templates, or leave it on Use default template for a plain notification that names the task.
When the email sends
It depends on whether the task has a due offset.
- No due offset. The email goes the moment the task becomes available: when onboarding starts if the task has no prerequisite, or when its prerequisite is finished.
- With a due offset. The email goes on the task's due date, which is the start date on the candidate's accepted offer plus the offset. Recruit sends these in its daily run, so the email goes out on that day rather than at the moment of unlocking. Until then the task stays Not Started. A task still Locked is not sent until it unlocks.
- No start date yet. A timed task is held while the candidate has no accepted offer with a start date, and the Onboarding tab shows Waiting for start date in place of a due date.
How the due offset is counted is covered in "Setting due dates and prerequisites for onboarding tasks".
After the email is sent
The task marks itself Complete, which unlocks anything waiting on it, and the activity list records “Email trigger auto-completed”. If no recipient can be worked out, for example a blank reporting manager or a candidate with no email address, the task still completes, no email goes out and no error is shown.
A candidate email includes the link to their onboarding checklist and is recorded in their communication history. A task due date and phase are blank in trigger emails.
When nothing was sent
- Check the recipient in the template. A custom address must be a valid email address.
- If you chose Reporting manager, check the Reporting Manager box on the candidate's onboarding holds an email address, not a name.
- If you chose Candidate, check the candidate has an email address on their profile.
- If the task has a due offset, check the due date has arrived and that the task is not showing Waiting for start date.