Skip to content
English
Contact us
  • There are no suggestions because the search field is empty.

Portal Registration Email Error Message

Audience: Administrators, Support Teams

Overview

When users attempt to register on the Work 365 Self-Service Portal, they may encounter an “Email Error” or similar message indicating that the registration email could not be sent.

This issue typically occurs due to missing permissions, inactive email templates, or misconfigured sender/domain settings within the environment.

Common Causes

  • Category: ? Insufficient Roles Assigned Description: The Work 365 Application User does not have the required security roles to send emails.
  • Category: ? Missing or Misconfigured Email Template Description: The registration email template is inactive, missing fields, or was deleted.
  • Category: ? Unverified Sender Domain Description: The “From” address is not authorized or lacks proper DNS authentication (SPF/DKIM).
  • Category: ⚙️ SMTP or Portal Configuration Issues Description: The portal’s email service credentials or SMTP settings are invalid or expired.

Resolution Steps

1. Verify Work 365 Application User Roles

  1. In Dynamics 365, go to:
    Settings → Security → Users

  2. Change the view to Application Users.

  3. Locate the Work 365 Application User (use the Application ID if needed).

  4. Click Manage Roles and ensure only the following roles are assigned:

    • ✅ Work 365 Service

    • ✅ Work 365 Portal Service

  5. Remove any other roles and click Save.

? Tip:
If you recently switched from a Service Account to an Application User, refresh configuration via:
Work 365 Admin Hub → Change Service User → Clear Cache

2. Check the Portal Registration Email Template

  1. Navigate to Work 365 → Email Templates.

  2. Locate the Portal Registration template.

  3. Verify that the following fields are valid:

  • Field: Status Validation Requirement: Must be set to Active
  • Field: From / To / Subject Validation Requirement: Must contain valid values or placeholders
  • Field: Body Validation Requirement: Must include registration placeholders (e.g., registration link)

? If the template is missing:

  • For Portal Templates: Reinitialize the Self-Service Portal Configuration

  • For Core Templates: Re-run Admin Consent for Work 365

Then refresh the Email Templates view to confirm restoration.

3. Confirm Sender Domain and “From” Email Address

Ensure the From address belongs to a verified and authorized domain.

Verify your DNS setup includes:

  • ✅ SPF record (includes your mail service)

  • ✅ DKIM record (if applicable)

If using Microsoft 365 as the sender:

  • Confirm the mailbox exists and is licensed.

  • Ensure the mailbox has permission to send outbound mail.

4. Validate Portal Email / SMTP Configuration

In the Power Platform Admin Center:

  1. Select your Power Pages site.

  2. Review Email / SMTP Configuration and confirm:

    • Credentials or API keys are valid and active.

    • Outbound email functionality is enabled.

    • Test emails send successfully.

5. Retry Registration and Monitor

✅ Have the user retry the registration.
? Monitor results via:

  • Portal activity logs

  • SMTP or email provider logs

  • Work 365 Email Reports (if enabled)

Example Error Messages

“Unable to send registration email. Please contact the administrator.”
“Mail delivery failed for registration request.”

? Tip: Capture a screenshot and copy the full error text to assist with troubleshooting.

Notes & Troubleshooting Tips

? Test with a known working mailbox (e.g., admin@yourdomain.com).
? Review system logs for SMTP authentication or throttling errors.
? If the portal URL was recently changed, update redirect URIs and registration links.
? For dynamic “From” addresses, ensure all senders are verified and authorized.