Vonage SDK

Backend & Infra

Vonage Server SDK for Python. API support for Voice, SMS, WhatsApp, Verify (2FA), Video Meetings and more.

Latest: v4.7.214 releases1 breaking changes2 common errorsUpdated Oct 9, 2025View on GitHub

Release History

v4.7.21 fix

Oct 9, 2025

This minor release includes a fix for updating number dumps within the vonage-numbers module by ensuring by_alias=true is set.

v4.7.11 feature

Sep 26, 2025

This minor release adds missing transcription fields to the SDK.

v4.7.01 feature

Sep 19, 2025

This release introduces a new quantization parameter for video archives functionality.

v4.6.01 feature

Aug 16, 2025

This release introduces a new bidirectional websocket flag for video features, enhancing real-time communication capabilities.

v4.5.2

Jul 31, 2025

This release is solely a fix for the publish version and is functionally identical to version 4.5.1.

v4.5.12 fixes

Jul 30, 2025

This patch release includes minor bug fixes related to video filtering and handling special characters in RCS messages.

v4.5.01 feature

Jul 1, 2025

This release introduces a new messages failover feature. It also welcomes a new contributor to the project.

v4.4.3Breaking

May 9, 2025

The vonage-number-insight integration has been updated to use basic header authentication instead of request body authentication.

v4.4.21 fix

May 8, 2025

This minor update adjusts the vonage-sms integration by making its returned response fields optional.

v4.4.11 feature

Apr 24, 2025

This release includes updates to some parameters within the Voice API.

v4.4.01 fix3 features

Feb 14, 2025

This release introduces new configuration options for SIP handling in the Vonage Voice Package and improves validation for recording downloads.

v3.18.0

Jan 31, 2025

No release notes provided.

v4.3.03 features

Jan 30, 2025

This release flattens the package structure by moving model imports from submodule paths (e.g., .models) to the top level of their respective packages (vonage_voice, vonage_video, vonage_messages).

v4.2.01 fix1 feature

Jan 14, 2025

This release introduces a new configuration option for Video API archives and resolves an issue with error types, alongside a minor type hint update.

Common Errors

JSONDecodeError1 report

JSONDecodeError often occurs when the `json.loads` function receives an empty string or a string that isn't valid JSON, commonly from HTTP 204 responses. To fix this, check if the response content is empty before attempting to decode it as JSON; if empty, return an appropriate default value like `None` or an empty dictionary instead of calling `response.json()`. This prevents the error when no JSON content is actually present in the response.

InvalidKeyError1 report

The "InvalidKeyError" in vonage-sdk usually arises from improperly configured or missing API credentials, specifically your API key, API secret, or application ID and private key for JWT authentication. To resolve this, double-check that your Vonage API key, API secret, application ID and private key file path are correctly set as environment variables or directly in your code, and ensure the private key is valid and not corrupted. Regenerate your key/secret or private key in the Vonage API dashboard if necessary, then update your configuration in your application accordingly.