Reply-To Email Settings: Change the Reply Address for Flow Emails

RapidPro includes a default email address for emails sent from flows. You can update these settings so that emails sent by flows use your own reply-to address, allowing recipients (or your team) to reply directly to an inbox you control.

Quick Setup Checklist

Use these steps to configure the reply-to address and SMTP settings so flow emails can be replied to from an inbox you control.

  1. Open Workspace Settings and locate the flow email section.
  2. Enter your email + SMTP host, credentials, port, and encryption.
  3. Save changes and test by triggering a flow email.
  4. Troubleshoot common SMTP and permission issues.
1
Open email settings

  1. Click the gear icon (⚙️) to open Workspace Settings.
  2. Scroll to the section labeled “Emails sent from flows will come from…” (or similar wording).
  3. Click the section to edit the configuration.

[CAPTURE: Workspace showing the gear icon (⚙️) in the bottom-left.]

[CAPTURE: Workspace Settings page scrolled to the “Emails sent from flows…” section.]

2
Fill in the email configuration

Complete the fields in the email configuration form:

  • Email Address: The email you want replies to go to (e.g., support@yourorg.org)
  • SMTP Host: Your email provider’s SMTP server (example: smtp.gmail.com)
  • Username: Usually the full email address (e.g., support@yourorg.org)
  • Password: The password used for SMTP authentication
  • Port: Your provider’s SMTP port (commonly 587 for TLS)
  • Encryption: Prefer TLS when available

[CAPTURE: Email configuration form showing all fields (host, username, port, encryption).]

  1. Click Save to apply the changes.

[CAPTURE: Save button + success confirmation toast (if available).]

3
Notes on Gmail and app passwords

If your email account uses two-factor authentication (2FA), your normal password may not work for SMTP. In that case, you’ll typically need an App Password from your email provider and use that in the Password field.

[CAPTURE: Example “App Password” screen (optional, only if you have permission to show it).]

Common Issues & Fixes

My password doesn’t work

Possible cause: The email account uses 2FA and requires an app password.

Fix: Create an App Password in your email provider, then paste that value into the Password field.

Emails aren’t sending from flows

Possible causes: Incorrect SMTP host/port, encryption mismatch, or wrong credentials.

Fix: Recheck SMTP host + port, confirm TLS, verify username/password, then save and retest.

I don’t see the “Emails sent from flows…” section

Possible cause: You’re not in Workspace Settings or you don’t have permission.

Fix: Confirm you’re in Workspace Settings, and that your user role allows editing workspace configuration.