Skip to content
Release: Australia · Updated: 2026-03-12 · Official documentation · View source

Vonage Provider custom configuration (Tutorial)

Configure a SMS with Vonage Provider to ensure every user can login securely.

Before you begin

Role required: adaptive_auth_admin

Procedure

  1. Navigate to All > System Web Services > Outbound > REST Message and perform the REST message configuration based on the information from Vonage API Dashboard.
Image omitted: vonage-dashboard.png
Vonage API Dashboard
  1. Click New to create a new REST Message.

  2. Provide a Name and Endpoint.

Image omitted: vonage-rest.png
Vonage REST Message configuration
  1. Click Submit.

  2. Open the created record, in the HTTP Methods related list, click New and select the HTTP method as POST.

  3. Fill the following fields:

    • Endpoint: https://${baseURL}/sms/json
    • Content:api_key=${apiKey}&api_secret=${apiSecret}&text=${text}&from=${from}&to=${to}
    • Content-Type: application/x-www-form-urlencoded
Image omitted: vonage-http-method.png
HTTP Method
  1. Update the record.

  2. Click Auto-generate variables from the Related Links section.

  3. Import SI shared in the folder and copy the apiKey and secret from the Vonage API dashboard.

    Note:

    The apiKey and secret are located in your Vonage account settings in the Vonage Dashboard.

Image omitted: vonage-script.png
Script
  1. Create a custom Table Phone Numbers with two columns, For example:

    • Column Label: User, Type: Reference, Reference: User (sys_user).
    • Column Label: Phone Number, Type: Phone Number(E164).
Image omitted: vonage-phone-number.png
Phone Number
  1. Create a custom provider in Multi-Factor Provider table.
Image omitted: vonage-provider-config.png
Provider Configuration page
To know more about provider configuration, see [Configure MFA Provider](configure-mfa-provider.md).