---
layout: integration
title: SMS with Vonage
description: Send customized SMS messages to your users through Vonage
date: 2026-11-06
featured: false
isPartner: true
isNew: true
cover: /images/integrations/sms-vonage/cover.avif
category: messaging
product:
    vendor: Vonage
    description: "Vonage is a cloud communications platform that provides APIs for SMS, voice, video, and messaging apps."
platform:
    - 'Self-hosted'
    - 'Cloud'
---

[Vonage](https://www.vonage.com/communications-apis/sms/) is a cloud communications platform with APIs for SMS, voice, video, and messaging apps such as WhatsApp. Its SMS API sends text messages from virtual numbers that you buy in the Vonage dashboard.

# How does the integration work?

You can use the Vonage provider in Appwrite Messaging to send customized SMS messages to your users, such as reminders, promotions, announcements, and custom authentication flows. Messages can be sent immediately or scheduled, to [topics](/docs/products/messaging/topics), users, or individual [targets](/docs/products/messaging/targets).

Appwrite authenticates with Vonage using your API key and API secret, and sends your messages through the Vonage SMS API.

# How to implement

To implement the Vonage provider in Appwrite Messaging, there are several steps you must complete:

## Step 1: Set up Vonage

First, [sign up for a Vonage account](https://dashboard.vonage.com/sign-up) and buy a virtual number with SMS capability. Then save the following information from the Vonage dashboard:

| Field name | |
| --- | --- |
| API key | Head to **Build & manage** > **API settings** and copy the API key. |
| API secret | Head to **Build & manage** > **API settings** and copy the API secret. |
| Sender number | Head to **Build & manage** > **Numbers** > **Your numbers** to find the number your SMS messages are sent from. |

## Step 2: Add the Vonage provider to your Appwrite project

For this step, you must [create an account on Appwrite Cloud](/sign-up) or [self-host Appwrite](/docs/advanced/self-hosting) if you haven't already. In your Appwrite project, head to **Messaging** > **Providers**, click **Add provider**, and choose **SMS**. Give your provider a name, choose **Vonage**, and click **Save and continue**.

In the **Configure** step, add the **API key** and **API secret** you saved from the Vonage dashboard. Enter the **Sender number** with a leading `+` and the country code, such as `+14155550123`. Click **Save and continue** to enable the provider.

## Step 3: Test the Vonage provider

Before you proceed, you must already have at least one [topic](/docs/products/messaging/topics) or [target](/docs/products/messaging/targets) set up.

Go to **Messaging** > **Messages**, click **Create message**, and choose **SMS**. Write a test message, select one of your test targets, set the schedule to **Now**, and click **Send**. Check that the SMS arrives on your phone. If it doesn't, check the logs in the Appwrite Console and in your Vonage dashboard.

To send SMS messages from your backend instead, follow the [Send SMS messages](/docs/products/messaging/send-sms-messages) guide with an [Appwrite Server SDK](/docs/sdks#server).

# Read more about Vonage and Appwrite Messaging

If you would like to learn more about Vonage and Appwrite Messaging, we have some resources that you should visit:

- [Vonage SMS API overview](https://developer.vonage.com/en/messaging/sms/overview)
- [Set up the Vonage provider in Appwrite Messaging](/docs/products/messaging/vonage)
- [Send SMS messages through Appwrite Messaging](/docs/products/messaging/send-sms-messages)
- [Phone auth with Vonage on self-hosted Appwrite](/integrations/phone-auth-vonage)
- [WhatsApp with Vonage](/integrations/whatsapp-vonage)