Secure Your Account: Enabling Two-Factor Authentication (2FA)

Your RapidPro.app account controls sensitive data and powerful messaging flows. A password alone may not be enough to protect it. Two-Factor Authentication (2FA) adds a second step at login so only you – with your password and your phone – can access your account. In this guide, you’ll learn how to: Turn on 2FA in your RapidPro.app account, Connect an authenticator app using a QR code, Store your authenticator secret safely for future recovery.
Reading time
4–5 min read
Category
Getting Started 
Scope
Updated on: 16/12/2025

Activate 2FA in a few steps

If you already know what 2FA is and just need the “fast path”, follow this:

  1. Open your Account page from your profile icon
  2. Go to Two-Factor Authentication
  3. Click Activate
  4. Scan the QR code with your authenticator app
  5. Save the authenticator secret in a secure place
  6. Enter the 6-digit Authenticator code from your app
  7. Click Activate and confirm your password if prompted

You’re done. From now on, RapidPro.app will ask for a 2FA code when you log in.

Step-by-Step Process

1
Open your account settings
  1. Log in to your RapidPro.app workspace.
  2. Locate your profile icon / initials in the interface (for example, in the top-left or side navigation).
  3. Click the profile icon to open the menu.
  4. Select Account to open your profile and security settings.

💡
Tip: If you use multiple devices or browsers, 2FA will protect your user account across all of them.

2
Go to the Two-Factor Authentication section
  1. On the Account page, scroll until you see the Two-Factor Authentication (2FA) section.
  2. Check the current status. If 2FA is off, you will see an Activate button.

⚙️
Technical Detail: This setting controls whether RapidPro.app requires a time-based one-time code (TOTP) from an authenticator app during login.

3
Start the 2FA activation flow
  1. Click Activate in the Two-Factor Authentication section.
  2. A setup panel appears showing:
    • A QR code
    • An Authenticator secret (a long string, e.g. 7KURWQIPOK9CUP6B5UK37MWLHEAH2QZT)
    • A field for your Authenticator code (the 6-digit code from your app)

⚠️
Warning: Do not share the QR code or the authenticator secret with anyone. Anyone with this information can generate valid 2FA codes for your account.

4
Scan the QR code with your authenticator app
  1. On your phone, open your authenticator app (for example, Google Authenticator, Authy, or Microsoft Authenticator).
  2. Tap Add account or the + button.
  3. Select Scan QR code.
  4. Point your camera at the QR code displayed in RapidPro.app until the app recognizes it.
  5. After scanning, the app will show a 6-digit code for RapidPro.app that refreshes every few seconds.
💡
Tip: If your camera cannot scan the QR code, most authenticator apps let you add an account manually by entering the Authenticator secret displayed in RapidPro.app.
⚙️
Technical Detail: The QR code and the authenticator secret represent the same shared key. Your authenticator app combines this secret with the current time to generate time-based one-time passwords (TOTPs).

5
Save your authenticator secret securely
  1. Locate the Authenticator secret shown on the 2FA setup panel (for example, a long string like 7KURWQIPOKVCUP6B5UK37MW2HEAHMQZT).
  2. Copy this secret and store it in at least one secure place, such as:
    • A password manager
    • An encrypted secure note
    • A printed copy stored in a locked drawer or safe

⚠️
Warning: Treat the authenticator secret like a master key. If someone else gains access to it, they can generate valid 2FA codes for your account. If you suspect it has been exposed, disable 2FA and set it up again to generate a new secret.

6
Enter the 6-digit authenticator code and activate 2FA
  1. In your authenticator app, look at the 6-digit code next to your RapidPro.app entry.
  2. In the Authenticator code field on the RapidPro.app 2FA setup panel, type the current 6-digit code.
  3. Click the Activate button.
  4. If prompted, enter your RapidPro.app password to confirm the security change.

⚙️
Technical Detail: RapidPro.app may request your password as an extra safety check when changing critical security settings, to prevent unauthorized changes from an already-open session.
💡
Tip: If the code fails, wait for the next code in your authenticator app and try again. Make sure your phone’s time and date are set automatically.

7
Confirm 2FA is working
  1. After activation, verify that the Two-Factor Authentication section now shows 2FA as Enabled.
  2. Log out of RapidPro.app.
  3. Log back in using:
    • Your email
    • Your password
  4. When prompted, enter the 6-digit code from your authenticator app.
  5. If you can sign in successfully, your 2FA setup is complete and working.

⚠️
Warning: If you lose both your phone and your authenticator secret, you may be locked out of your account and need help from an administrator or support. Make sure your recovery information is stored safely before relying on 2FA.

Common Issues & Quick Fixes

Problem: I don’t see the QR code.

Fix: Ensure you clicked Activate in the 2FA section and confirmed your password if requested. Refresh the page if needed.

Problem: The 6-digit code is always “invalid”.

Fix: Check that your phone’s time and date are correct and set to automatic. Wait for the next code and enter it quickly.

Problem: I changed my phone and lost my authenticator app.

Fix: Use the stored authenticator secret to re-add RapidPro.app in your new authenticator app. If you don’t have it, contact your admin or support for assistance.

Related Resources
Sign Up: Creating Your Account
User Management: Adding and Managing Team Roles Settings Overview: The Core of Your Workspace