How do I set up my access and Twilio Authy?

Once your business has been onboarded and has passed all verification checks, or you've been created as a new user on the Portal, you'll receive a 'Welcome' email from us with instructions on how to complete your access setup.

You'll need to download, install and register an app on your phone (available for iOS or Android) called Twilio Authy before you follow the link in the Welcome email as it is required to complete your access setup in the Modulr Portal.

Twilio Authy is an app you install on your mobile available from your device's app store, connected to your Modulr access, and provides an authentication step when you sign in as well as when you perform certain tasks in the Portal. See more details on Twilio's website → (you'll leave this page).

The video below outlines the steps involved.



It’s a good idea to download and register the app on your phone before you click the link in the Welcome email to start your set up.

The steps to register are the same for mobile – just the mobile screens are shown below

Twilio Authy download details → (you'll leave this page)
More information about setting up and using Authy can be found on Twilio's website → (you'll leave this page)

Authy app download and setup

1. Download and register the Twilio Authy app on your phone

Open the mobile app and enter the country code of your mobile number

(start typing the country name to find your country)

Enter your mobile number

Request a 6-digit code by SMS

You'll receive a code in an SMS (text message) on your phone

Enter the 6-digit code from the SMS into the screen on the phone

That's the app registration complete – there's no need to select 'Add Account' or use the 7-digit code you may see in the app – just sign in to the portal and follow the instructions onscreen to complete linking Authy to your Portal access.

Turn on notifications

It's a good idea to make sure you have notifications for Authy turned on on your phone.

Modulr Portal Authy setup

2. Sign in and link Twilio Authy to your Modulr Portal access

Select the button in your Modulr welcome email


Note – Welcome link expiry

For security reasons, the link in the Welcome email to sign in will expire in 48 hours from when the email was sent. You can request another email to be sent should this happen – you’ll see a message when you click the link.

Sage users
If you are a Sage user and the link has expired, please contact Support who will resend the Welcome email.

First time sign in – Create a password


Sage users

Sage users: Sign in with your Sage ID – you don't need to set up a password – skip to step 3


Creating a password in the Modulr Portal

The link in the welcome mail will take you to a screen where you set up your password. Follow the guidance on screen so you meet the password criteria:

  • Use at least 12 characters
  • Use upper and lower case letters
  • Use numbers, and symbols like @, &, ! Etc
  • Passwords can’t be the same as your username

3. Set up Twilio Authy with the Modulr Portal

The next screen you see summarises the steps to get registered in the Twilio Authy app. If you’ve already done this (Step 1 above), that's fine. If not, download and register the app before you click the link in the Welcome mail. Confirm on screen once you’ve registered the Twilio Authy app.

In the Modulr portal screens

  1. Select "I've installed and registered the app"

  1. Enter your mobile number you used when you registered the Authy app.

  1. You’ll receive an SMS (text message) on your phone with a 4-digit code

  1. Enter the 4-digit code in the screen in the Modulr portal

  1. Enter the large 7-digit code that's displayed on your Authy app's main screen (you may need to select 'Tokens' to view it) into the Modulr Portal.

You’ll then be signed in to the Modulr Portal with Authy set up.


Additional user using the same mobile number

If you are:

  • Already a user, and have registered with Authy
  • And you're now setting up another user using the same mobile number:

When you are asked to enter the mobile number in the Modulr portal signup, you'll see a message in the Authy app asking if using the same mobile number is OK. Simply select 'Yes' to continue setting up the new user.


What is two factor authentication?

Two-factor authentication is where there are two steps of validation required to perform certain actions. This provides an additional layer of security to the action being performed.

This means users not only have to be signed in with a valid username and password (something they know) but ALSO respond to a notification sent to their mobile phone (something they have).

This reduces the risk that the user performing the action isn't really them. (eg: someone may be able to guess a user's username and password and sign in as them, but it is more unlikely that they will also have their mobile phone access, so will not be able to perform any actions posing as the user).

See also

When do I need to use Authy? →
What do I do when Authy is required? →
How do I change my password? →