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.
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
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
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
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
%swhere the code goes; left empty, it is the default below.Sign Name Casdoor Template code Your verification code is %s. - 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.
More providers
View allAuthelia
OAuth providerLet people sign in to Casdoor through Authelia over OpenID Connect: the provider settings, and the client to add to Authelia's configuration.
authentik
OAuth providerLet people sign in to Casdoor with their authentik accounts over OpenID Connect: the provider settings, and the application and OAuth2 provider to create in authentik.
GitLab Self-Managed
OAuth providerLet people sign in to Casdoor with accounts on your own GitLab over OpenID Connect: the provider settings, and the OAuth application to create in GitLab.
