CasdoorMarketplace

Vonage · SMS provider

Send verification codes with Vonage

Use your Vonage account to text the verification codes Casdoor sends when users sign up, sign in with a code, reset a password or use SMS as a second factor. Casdoor sends each message through the Vonage SMS API and reports Vonage's error if a message is refused.

Verified by CasdoorSMSVerification codeGlobal
You need a running Casdoor, self-hosted or on Casdoor Cloud. In the examples, replace https://auth.example.com with your Casdoor address (on Casdoor Cloud, something like https://acme.casdoor.com) and the other example.com addresses with your own.

Set up Vonage with Casdoor

  1. 1

    Get the API key and secret

    Sign in to the Vonage API Dashboard and copy the API key and API secret shown at the top of the dashboard.

  2. 2

    Install Vonage from the Marketplace

    On the Marketplace page of Casdoor, install Vonage and enter the API key as the client ID and the API secret as the client secret. Casdoor adds an SMS provider of type Plugin with the same name.

  3. 3

    Set the sender and the text

    On the provider's page, set Sign Name to the sender: a number you rent from Vonage, or an alphanumeric sender ID of up to 11 letters and digits where the destination country allows one. Template code is the text of the message, with %s where the code goes; left empty, it is the default below.

    Sign NameCasdoor
    Template codeYour verification code is %s.
  4. 4

    Send a test message

    Enter your own phone number next to SMS Test on the provider's page and send a test message, then add the provider to an application's Providers with the rules you need, such as sign-up, sign-in or MFA.

Good to know

  • A trial Vonage account can only send to the test numbers you have added in the dashboard; add credit to send to any number.
  • Some countries, such as the United States and Canada, do not accept alphanumeric sender IDs, and some need the sender or the template registered first. Check Vonage's country-specific features before sending there.
  • A text with characters outside the GSM alphabet, such as Chinese or emoji, is sent as unicode, which fits fewer characters into one message.

Vonage settings are from its documentation as of November 2026 (Vonage SMS API reference, Vonage SMS API overview). Vonage is a trademark of its owner.

Frequently asked questions

Does Casdoor run code from the Marketplace for this?

Yes, a small WebAssembly module that runs inside Casdoor in a sandbox. It cannot read files or the database, and can only send requests to rest.nexmo.com.

Does it use Vonage Verify?

No. Casdoor creates and checks the code itself and only uses Vonage to deliver the text, so the code works the same way as with Casdoor's other SMS providers.