Email Notification Customization
HYPR Affirm sends email notifications during verification flows: an approver invitation, a one-time passcode (OTP) when the code goes by email, and a Helpdesk verification invitation. It also sends two emails to Helpdesk portal users: an invitation and a login recovery. Affirm uses the cross-product Control Center email-template system, so a custom template authored once applies to every product that sends that notification type.
This page describes what the recipient sees and the Affirm email types that can be branded. For the configuration walkthrough (template editor, version management, image uploads), see Email Notification Customization (Control Center documentation).
Email Notification Categories Affirm Sends
Affirm sends emails in the following scenarios:
- Approver invitations: when a verification flow assigns a human approver (manager, custom email or escalation approver), the approver receives an email with a link into the review
- OTP delivery for email-based verification: when the Phone Number or Email Verification step sends the passcode by email rather than text message
- Helpdesk verification invitations: when a Helpdesk operator starts a verification flow for a caller, the caller can receive the verification link by email
- Helpdesk portal user invitations: when an administrator adds a user to the Affirm Helpdesk, the user receives an email with a link to register a device for the Helpdesk portal
- Helpdesk portal login recovery: when an administrator resends the link to a Helpdesk portal user, the user receives an email with a link to register a new device
Each of these is a separate notification type in the Control Center Notification Settings, and each can have a custom template with its own active version.
Default Email Text
Each default template starts with the HYPR logo and ends with the same footer: "If you have any questions, please contact" followed by your support email, then "Helpful links: Privacy Policy | Contact HYPR". The support email comes from Custom Branding.
Approver Invitation
The following table lists the default approver invitation text.
| Part | Default text |
|---|---|
| Subject | "HYPR Identity Verification Request" |
| Heading | "Identity Verification Request:" followed by the requester's name |
| Body | "Hi there!" "Could you please review if the user's identity looks good based on the live proof they've provided? Just a quick heads-up: make sure to review carefully before giving your approval." |
| Button | "Click to Review" |
An approver invitation email shows the configured logo, color theme, subject, body copy and a button that opens the review.
An approver invitation email rendered with the default HYPR template. With a custom template active, the logo, color theme, subject and body copy are replaced; the review link is inserted into the template at send time.
One-Time Passcode
The following table lists the default passcode email text.
| Part | Default text |
|---|---|
| Subject | "HYPR Identity Verification One-Time Passcode" |
| Heading | "Identity Verification One-Time Passcode:" |
| Body | "Hi there!" "Here's your One-Time Passcode to use in your verification flow:" followed by the code |
Helpdesk Verification Invitation
The following table lists the default Helpdesk verification invitation text.
| Part | Default text |
|---|---|
| Subject | "HYPR Identity Verification Request Invite" |
| Heading | "Identity Verification Request:" |
| Greeting | "Hello" followed by the requester's name |
| Body | "Your organization is requesting that you verify your identity." |
| Button | "Click to Begin" |
Helpdesk Portal User Invitation
The following table lists the default text of the email a new Helpdesk portal user receives.
| Part | Default text |
|---|---|
| Subject | "Your HYPR Invitation |
| Heading | "Welcome to Affirm Helpdesk" |
| Greeting | "Hello" followed by the user's first name |
| Body | "Your organization has invited you to register for an account on the HYPR Affirm Helpdesk." |
| Button | "Start Enrollment" |
Helpdesk Portal Login Recovery
The following table lists the default text of the email a Helpdesk portal user receives when the link is resent.
| Part | Default text |
|---|---|
| Subject | "Your HYPR Login Recovery |
| Heading | "Affirm Helpdesk Login Recovery" |
| Greeting | "Hello" followed by the user's first name |
| Body | "Need to recover your login? Click the link below to register a new device with HYPR Control Center. You can also choose to remove your old device if it is no longer in your possession." |
| Button | "Register New Device" |
What's Branded
When a custom Affirm email template is active, the recipient sees:
- Your organization's logo (uploaded as part of the template)
- Your color theme applied to the email layout
- Your custom subject line and body content
- Affirm data filled in at send time, such as the recipient's or requester's name, the passcode and the verification or review link
If no custom template is active, Affirm uses the HYPR default template for that notification type.
Affirm Placeholders
Affirm templates use the Control Center attribute syntax for placeholders. The following table lists the attributes the Affirm templates use.
| Attribute | What it holds | Used in |
|---|---|---|
{{attr::fullName}} | The requester's name | Approver invitation, Helpdesk invitation |
{{attr::firstName}} | The Helpdesk portal user's first name | Helpdesk portal user invitation, Helpdesk portal login recovery |
{{attr::inviteLink}} | The link to the review, to the verification flow, or to register a device for the Helpdesk portal | Approver invitation, Helpdesk invitation, Helpdesk portal user invitation, Helpdesk portal login recovery |
{{attr::otpCode}} | The one-time passcode | Passcode email |
{{global::supportEmail}} | Your tenant's support email | All |
For the attribute reference and the full list of global attributes, see the Control Center email customization documentation.
Approver and Helpdesk invitation emails contain time-limited links. Do not log the email body or show the link anywhere other than to the recipient. The link opens the verification or review for the named recipient.
OTP by Email Versus SMS
For the Phone Number or Email Verification step, the administrator chooses whether the requester gets the passcode by text message, by email or with a choice of either. If your tenant uses both channels, follow these guidelines:
- Align the passcode email wording with the text message so a requester switching between channels sees consistent wording. The text message wording is fixed; see SMS Notification Branding.
- Use the extra room email allows for additional context, such as help desk contact information or what to do if the code doesn't arrive.
Related
- SMS Notification Branding: text message counterpart for the same notification types
- Custom Branding: Company Identity values referenced by email templates
- Code Customizations: Email: programmatic email transport override (custom SMTP or transactional provider)
- Email Notification Customization (Control Center): template editor reference