---
id: vonage-messages
version: "1.7.1"
license: unclear
license_treatment: permissive
maintenance: active
---

# vonage-messages — Vonage messages package

License: permissive · Maintenance: active · Downloads: 338.0K/mo

## What it is and what it does

vonage-messages is a Python package that provides typed message models and integration helpers for Vonage's Messages API. It lets you construct and send messages across multiple channels—SMS, MMS, RCS, WhatsApp, Messenger, and Viber—by instantiating the appropriate message class (Sms, WhatsappText, MessengerImage, etc.) and passing it to a Vonage client's send method. The package is designed to be used as part of the main vonage package and relies on vonage-http-client for API communication and pydantic for message validation.

The package abstracts away API endpoint details and request formatting, letting you work with strongly-typed message objects instead of raw JSON. It supports message-type-specific options through submodels (e.g., MessengerOptions, MessengerResource) and provides convenience methods for channel-specific operations like marking WhatsApp messages as read or revoking RCS messages. It requires Python 3.9+ and depends on three runtime packages: vonage-http-client, vonage-utils, and pydantic.

Use it for:

- Send SMS notifications or alerts from a Python application using the Sms message model
- Build multi-channel messaging workflows that route messages to WhatsApp, Messenger, or Viber based on user preference
- Send rich media messages (images, audio, video, files) via MMS, RCS, or WhatsApp with typed message models
- Manage WhatsApp message state by marking messages as read or revoking RCS messages via Vonage API methods
- Integrate Vonage messaging into a larger application using the main vonage package with pre-built message types

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides Python message models and client integration for Vonage's Messages API, supporting SMS, MMS, RCS, WhatsApp, Messenger, and Viber message types.

Yes. vonage-messages is actively maintained, has low install friction, carries a permissive Apache license, and provides a clean, typed interface to Vonage's multi-channel messaging API. Install it if you need to send messages across SMS, MMS, RCS, WhatsApp, Messenger, or Viber from Python. It is best used as part of the main vonage package rather than standalone.

## Install

pip install vonage-messages
uv add vonage-messages
poetry add vonage-messages

## Installing vonage-messages

Before you install: Low install friction with pure Python wheel distribution. Active maintenance as of late July 2026, with recent release activity and 213 repository stars.

License in practice: Licensed under Apache Software License (permissive), allowing commercial and private use with minimal restrictions.

Quickstart:

pip install vonage-messages

from vonage_messages import Sms
from vonage import Vonage, Auth

auth = Auth(application_id='my-app-id', private_key='my-key')
vonage_client = Vonage(auth)

message = Sms(from_='Vonage', to='1234567890', text='Hello')
vonage_client.messages.send(message)

Requires Python 3.9 or later. Vonage API credentials (application_id and private_key) are needed to authenticate and send messages.

Verify before relying:

- Rate limits or quota restrictions on message sending through the Vonage API
- Delivery guarantees or retry behavior for failed message sends
- Regional API endpoint availability and latency characteristics

## Package facts

- License: not declared (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 338.0K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

vonage messages api python, send sms whatsapp rcs python, vonage sdk messaging, multi-channel messaging api, vonage python client, sms mms messaging library, messaging-api, vonage, multi-channel

[View on SkillFed](https://skillfed.io/packages/vonage-messages) · [View on PyPI](https://pypi.org/project/vonage-messages/)