Email Settings: Properly Configuring Password Emails
How the "Reset password" and "Set password upon first login" toggles work, and what to keep in mind regarding SSO and user creation
Overview of Account Emails
Under Administration > Email Settings, you define which emails E-Coach sends on behalf of your organization. You can also access this page via the Email Settings tile in the "System & Security" section of the Administration menu. It is visible only to SuperAdmins.
Under the Account Emails section, you will find two switches. Both are enabled by default and apply to all users across your tenant. Any changes take effect immediately.
| Switch | What It Controls | When Disabled |
|---|---|---|
| Reset password | The email containing the link to reset a forgotten password, requested via "Forgot password?" on the login page. | The "Forgot password?" link is hidden on the login page. Users who access the reset URL directly will see a notice that password resets via email are unavailable. Users can no longer reset passwords on their own. |
| Set password upon first login | The onboarding email containing the link that allows newly created users to define their password prior to their initial login. | New users do not receive this activation link. Whether they can still sign in depends on how their account was created and whether SSO is enabled (see below). |
Note
Neither switch prevents creating or importing users. E-Coach will still create accounts even if the user is initially unable to sign in as a result. This behavior is deliberate, as not all users should necessarily receive account emails. Before disabling these toggles, verify how your users will obtain their credentials.
The initial account setup email for the first SuperAdmin of a new tenant is unaffected by these settings.
How New Users Receive Their Initial Password
When adding a user under Administration > Users, two options in the creation form determine how that user obtains their initial password. Account email settings only affect one of these paths.
| Creation Setting | What Happens | Dependent on Email Settings? |
|---|---|---|
| Email communication enabled and Require password change upon first login enabled | E-Coach assigns an undisclosed, random system password internally and sends the user a link to set their own password. | Yes. If "Set password upon first login" is disabled, no link is sent. |
| Email communication enabled, without requiring password change upon first login | E-Coach assigns an undisclosed, random system password internally and sends no email. This workflow is intended for users authenticating via SSO with their Microsoft account. | No. Without SSO, the user can only acquire a password via "Forgot password?". |
| Email communication disabled | You assign a temporary initial password (suggested by the form) and deliver it securely to the user. The user must change it during their first login. | No. This approach functions independently of the tenant email settings. |
| User Import | Imported users are always created with email communication enabled and receive the setup link to define their password. Accounts without email communication cannot be imported. | Yes. If "Set password upon first login" is disabled, no link is sent. |
Recommended Settings
The ideal setup depends primarily on whether your organization authenticates users via Single Sign-On (SSO).
| Your Environment | Recommendation |
|---|---|
| No SSO | Keep both switches enabled. If you want to avoid automated password emails entirely, create users manually with email communication disabled and provide a temporary initial password. Avoid bulk imports for new users in this case. |
| SSO active, Login form displayed | Users with a corporate Microsoft account log in using SSO and do not need password emails. Keep "Reset password" enabled as long as individual accounts still sign in via password. |
| SSO active, Login form hidden | Both switches can safely be disabled since only SuperAdmins and external accounts authenticate via password. Create these specific accounts with email communication disabled and assign an initial password. |
Known Scenarios and Workarounds
The following situations can arise when a switch is turned off. These scenarios are documented and accepted by design so that system configuration does not block account provisioning. Workarounds are available for each case.
A new user cannot sign in
Situation: "Set password upon first login" is turned off, SSO is not active, and the user was created or imported with email communication enabled. The user does not know their password and did not receive a setup link. If "Reset password" is also disabled, logging in is entirely impossible for them.
During an import, affected rows are highlighted in the preview with the status Valid, login may not be possible. The import itself will not be blocked. The single-user creation form does not display this warning.
Workaround: If "Reset password" is enabled, the user can set a password independently via "Forgot password?" on the login page. Otherwise, proceed as follows:
Temporarily enable password reset
A SuperAdmin enables the Reset password switch under Administration > Email Settings.
Have the user set their password
The user clicks Forgot password? on the login screen, enters their email address, and configures their password using the received link.
Disable the switch again
Once the user has configured their password, the SuperAdmin disables Reset password once more.
Important
As long as "Reset password" is enabled, all users across your tenant can reset their passwords via email.
If "Set password upon first login" is re-enabled later, previously provisioned users will not receive the link retroactively. Have them use the "Forgot password?" route instead.
Tip
If the user does not yet have any monitorings or coachings attached, you can alternatively delete the user account and recreate it with email communication disabled and an initial temporary password. Deletion is permanent.
A user has forgotten their password
Situation: "Reset password" is turned off. The "Forgot password?" link is hidden, and administrators cannot reset passwords directly from the user management screen.
Workaround: Follow the steps described above: temporarily enable "Reset password", have the user set a new password via "Forgot password?", and then turn the toggle back off.
A SuperAdmin or external user requires a password while SSO is active
Situation: SSO is active, and both switches are turned off. An account lacking a Microsoft identity (such as an external third party) was created or imported with email communication enabled. They do not receive an activation link and cannot log in. No import warning is generated in this scenario because SSO is active.
Workaround: Configure such accounts directly from the start as follows:
Create user without email communication
When creating the account, disable Email communication enabled, and either accept the suggested temporary password or define a custom one.
Flag as an external user
If the login form is hidden, edit the user account and enable the External user switch. This toggle is only visible to administrators authorized to manage SSO.
Deliver the password securely
Provide the temporary initial password to the user via a secure channel. The user must change it upon first logging in.
For an existing account already created this way, use the "Forgot password?" workaround. When the standard login form is hidden, SuperAdmins and external users can access the password authentication fields by selecting Log in locally on the login page.