Onboarding email notifications
Citrix Secure Developer Spaces™ (SDS) sends automatic email notifications that help new users find their way onto the platform and into their projects. These emails give recipients a direct sign-in link, so they can get started without waiting for manual instructions.
This page explains which emails SDS sends, when each one is triggered, and what recipients see. It’s written for platform administrators and project owners who onboard users.
Note:
Email notifications are only delivered when an email gateway is configured. See Prerequisite: configure an email gateway.
How onboarding emails work
SDS generates an onboarding email whenever an event adds a user to the platform or to a project. The platform builds the message from a template, personalizes it with details such as the inviter’s name and a sign-in link, and sends it through the configured email gateway.
Recipients don’t need an existing account to receive these emails. Each email includes a button that takes the user straight to the sign-in page or the relevant project.
Prerequisite: configure an email gateway
Onboarding emails are sent through the email gateway defined in System Configuration. Until a gateway is set up, SDS generates no onboarding emails.
To set up the gateway:
- Sign in as a platform administrator and select System Configuration.
- Select Others > Email Gateway Configuration.
- Choose a provider: Amazon SES, SendGrid, or SMTP.
- Enter the required details for your provider, including the Sender Email address recipients see in the From field.
- Select Save.
For the full list of provider fields, see Others.
Note:
The Sender Email address appears as the sender of every onboarding email. Use an address that recipients recognize and trust, and that your provider is authorized to send from.
Email types
SDS sends three onboarding emails.
| Trigger | Primary action | |
|---|---|---|
| Invitation to join the platform | A user is invited to the platform. | Sign In — opens the platform sign-in page. |
| You’ve joined a new project | A user is added to a project. | Access Project — opens the project. |
| Test email | An administrator sends a test from the email gateway settings. | None. Confirms that the gateway works. |
Invitation to join the platform
Sent when a user is invited to the platform for the first time. The email names the inviter and includes a Sign In button that opens the sign-in page with the recipient’s email address pre-filled.
You’ve joined a new project
Sent when a user is added to a project. The email names the project and includes an Access Project button that opens it.
Test email
Sent when an administrator uses the test option in Email Gateway Configuration. Use it to confirm that the gateway is set up correctly before you invite users. The test email doesn’t include an action button.
Troubleshoot onboarding emails
If a user reports that they didn’t receive an onboarding email:
| Check | What to do |
|---|---|
| Email gateway | Confirm that a gateway is configured under System Configuration > Others > Email Gateway Configuration. Without it, SDS sends no emails. |
| Gateway health | Send a test email from the gateway settings to confirm that the provider works. |
| Sender address | Verify that the Sender Email address is valid and authorized to send through your provider. |
| Spam or quarantine | Ask the recipient to check their spam or quarantine folder. Automated emails are sometimes filtered. |
| Email address | Confirm that the address used to invite the user is correct. |
If the test email arrives but onboarding emails don’t, re-check the event that should have triggered the email — for example, that the user was actually added to the platform or project.