Email Setup in OutSystems: SMTP Configuration, Templates, and Attachments

Navigate to Service Center (environment-url/ServiceCenter). Login as an administrator. Path: Administration → Email → Outgoing Email Settings. Fill in: - Server name (SMTP host): e.g., smtp.sendgrid.net - Port: 587 (STARTTLS) or 465 (SSL/TLS) - Enable TLS/SSL: Yes - Username: your SMTP username - Password: your SMTP password - Test connection → Save For Gmail SMTP: use smtp.gmail.com, port 587, enable 'Less secure app access' or use App Passwords. For SendGrid: Server = smtp.sendgrid.net, Port = 587, Username = 'apikey', Password = your SendGrid API key. After saving, the SMTP settings apply to ALL modules in this environment. Different environments (Dev, QA, Prod) can have different SMTP settings.

Email screens in OutSystems are specialized screens designed to produce HTML email content. They support Expression widgets with dynamic data and OutSystems UI email layout blocks. In Service Studio: Interface tab → Email (email-specific UI flow, separate from your regular UI flows). Right-click → 'Add Email'. Name it 'WelcomeEmail'. Add input parameters to the Email: right-click WelcomeEmail → Add Input Parameter: - UserName: Text - ActivationLink: Text Design the email body in the Screen Editor. Use: - Text widgets for static content - Expression widgets for dynamic content: UserName, ActivationLink - The built-in email layout that provides a basic header/body/footer structure Example email body: 'Hello [Expression: UserName],' + newline + 'Welcome to our platform. Click here to activate your account: [Link: ActivationLink]'

The Send_Email action is a built-in system action in Logic tab → System → Email. Create or open the Server Action where you want to send the email (e.g., 'RegisterUser' Server Action). After the user registration logic: Drag Send_Email from Logic tab → System → Email into the action flow. Send_Email input parameters: - From: 'noreply@yourapp.com' (or a Site Property: Site.SenderEmail) - To: UserEmail - Subject: 'Welcome to Our Platform — Please Activate Your Account' - Bcc: '' (optional) - Cc: '' (optional) - [Email Screen]: WelcomeEmail (select from dropdown) - UserName: NewUser.Name - ActivationLink: ActivationURL The email screen input parameters are mapped directly in the Send_Email call node. The platform renders the email screen to HTML and sends it.

1/* Send_Email action parameters */
2From:           "noreply@yourapp.com"
3To:             NewUser.Email
4Subject:        "Welcome to Our Platform"
5CC:             ""
6BCC:            ""
7Email:          WelcomeEmail
8  UserName:     NewUser.Name
9  ActivationLink: ActivationURL
10
11/* Full Server Action flow */
12Start
13  --> CreateUser: (user registration logic)
14  --> Assign: ActivationURL = BaseURL + "/activate?token=" + ActivationToken
15  --> Send_Email: (parameters above)
16  --> End

Send_Email accepts an Attachments input parameter — a list of EmailAttachment structures. EmailAttachment structure (from System library): - FileContent: Binary Data (the file content) - FileName: Text (the filename shown in the email) - MimeType: Text (e.g. 'application/pdf') To attach a PDF invoice: 1. Create Local Variable 'EmailAttachments' of type EmailAttachment List 2. Create Local Variable 'Attachment' of type EmailAttachment 3. Assign: Attachment.FileContent = InvoicePDF, Attachment.FileName = 'Invoice.pdf', Attachment.MimeType = 'application/pdf' 4. Call ListAppend(EmailAttachments, Attachment) — drag ListAppend from Toolbox → Built-in Functions → List 5. In Send_Email, set Attachments = EmailAttachments

1/* Building attachments list */
2Assign:
3  Attachment.FileContent = InvoicePDFContent  /* Binary Data */
4  Attachment.FileName    = "Invoice_" + IntegerToText(InvoiceNumber) + ".pdf"
5  Attachment.MimeType    = "application/pdf"
6
7ListAppend(EmailAttachments, Attachment)
8
9/* Send_Email with attachments */
10Send_Email:
11  From:        Site.SenderEmail
12  To:          Customer.Email
13  Subject:     "Your Invoice #" + IntegerToText(InvoiceNumber)
14  Email:       InvoiceEmail (email screen)
15  Attachments: EmailAttachments

After sending emails, check delivery status in Service Center. Path: Monitoring → Email. You see a log of all sent emails with: - Sent timestamp - From, To addresses - Subject - Status: Sent, Error, Queued - Error details if delivery failed Common delivery errors: - 'Authentication failed' — wrong SMTP username/password, or app passwords required - 'Connection refused' — wrong port, firewall blocking outgoing SMTP, or STARTTLS/SSL mismatch - 'Recipient address rejected' — the To address is invalid or the recipient server blocked it - 'Relay access denied' — your SMTP server requires authentication for the From address In Service Center: Factory → Modules → [Module] → scroll to find Pending Emails — emails are queued and sent by OutSystems asynchronously. If a module has pending emails that are not being sent, check the SMTP configuration.