Welcome user email
Overview
The welcome user email is sent when a user successfully registers for your application. It acknowledges the sign-up and introduces the portals and resources the user can access with their new account.
Key benefits
- Confirms successful user registration
- Introduces login access and portals
- Improves first-time user experience
Admin perspective
The welcome user email is managed under Communication Management. Templates are pre-seeded and can be enabled or disabled based on your requirements.
Details and configuration
- When will the welcome email be triggered
- The login link
- How to integrate using REST APIs
info
If your application requires email or mobile number verification, the welcome user email is sent only after the account is verified.

Configuration criteria
| Criteria | Description | Configuration |
|---|---|---|
| Activation / deactivation | Templates are pre-seeded for platform functionality. Some templates are intentionally disabled by default. Only mandatory templates required for cidaas core operations are enabled automatically. | Communication Management |
| Account verification | If verification is enabled, users must verify their account using OTP or a verification link before the welcome email is triggered. | — |

The login link is a dynamically generated parameter included in the welcome user email.
- The primary login link is derived from
app.initiate_login_uri. - As a fallback, cidaas reconstructs the authorization request to generate a login link.
- The fallback mechanism works only if
state,nonce, orcode_challenge(PKCE) are not used. - In fallback scenarios, the login link may be shortened.
The login link can be:
- Embedded in a button, or
- Displayed directly as linked text in the email template.

The triggered email includes a to parameter that defines the recipient of the email.
- The
login_linkis passed as metadata. - You can reuse the provided
htmlandsubjectfields. - The email can be sent using your own email provider.
Example payload
{
"from_email": "[email protected]",
"from_name": "noreply cidaas",
"to": "[email protected]",
"subject": "Welcome to the amazing Demo Introduction",
"html": "<PLACEHOLDER>",
"accept_language": "de",
"metadata": {
"name": "Pocahontas Disney",
"login_link": "https://demo.cidaas.eu/login",
"account_name": "demo-test",
"templateKey": "WELCOME_USER"
}
}
Explore related topics
- Communication Management overview
- Email templates
- Account verification settings
- Custom email providers
Support
Need Help?
For any further assistance, feel free to visit our Support Portal.