Set up phone authentication

Link to this section

You can allow users to use their phone number as their primary identity for authentication. This is a passwordless method, where we send a code via an SMS to verify the user on sign in.

You need a Twilio account to fully enable this feature. That’s because every SMS has a price and I’m afraid we can’t pay it for you.

ℹ️ If you just want to test this feature first, Kinde allows you to send 10 messages per month without setting up Twilio. If you want the feature to be live for your users, you must implement the full Twilio setup.

You will need these details from Twilio. They are all available in the dashboard of your Twilio account.

  • The SID of your Twilio account
  • The Auth Token for your Twilio account
  • Your Twilio phone number or the Messaging Service SID (if you set one up)

Refer to the Twilio documentation for assistance setting up.

Configure phone auth in Kinde

Link to this section
  1. In Kinde, go to Settings > Authentication.
  2. In the Identity connection section, select Configure on the Phone tile. The Configure phone authentication window opens.
  3. Select the Default country that you want to show on the authentication screen when users sign in.
  4. Enter the Twilio details from your Twilio account (see above) in the relevant fields.
  1. In the SMS source field, select either the Use Messaging service or Use phone number. Verification codes will be sent from whichever you choose.

    ℹ️ Note that the Twilio messaging service is more suitable for global applications as it detects where the sign in comes from and sends from an appropriate number.

  2. Depending on your selection in the previous step, enter either the Messaging service SID or Twilio Phone number in the relevant field.

  1. Select which applications you want to switch phone auth on for.
  2. Select Save.

SMS message format

Link to this section

You can’t customize the code message that user’s receive. We use a standard format as follows, to allow for easier translation.

Your verification code is [xxxxxx]

When you configure phone authentication, you’ll see that a Connection ID is automatically assigned. If you’re building a custom authentication experience, you’ll need the ID to trigger the phone authentication workflow.


Talk to us

If you can’t find what you’re looking for in our help center — email our team

Contact support