---
id: vonage-subaccounts
version: "1.0.4"
license: unclear
license_treatment: permissive
maintenance: active
---

# vonage-subaccounts — Vonage Subaccounts API package

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

## What it is and what it does

vonage-subaccounts is a Python package that wraps Vonage's Subaccount API, designed to be used as part of the main vonage package. It provides structured methods and data models (using pydantic) for managing Vonage subaccounts—creating new ones, modifying existing ones, and transferring resources like balance, credit, and phone numbers between accounts.

The package is actively maintained and supports Python 3.9 through 3.13. It abstracts away HTTP details by depending on vonage-http-client for transport and vonage-utils for shared utilities, so you interact with it through a vonage.Vonage client instance rather than making raw API calls. The description shows typical workflows: listing subaccounts, creating one with options, modifying suspension status, and executing various transfer operations with structured request objects.

Use it for:

- Create and manage multiple Vonage subaccounts programmatically for multi-tenant or reseller applications.
- Transfer balance or credit between subaccounts to rebalance account resources without manual intervention.
- Move phone numbers between subaccounts when reorganizing account structure or customer assignments.
- List and filter historical balance and credit transfers for billing, reconciliation, or audit purposes.
- Suspend or modify subaccount settings in response to business logic or customer lifecycle events.

## Worth the install?

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

Provides Python bindings to Vonage's Subaccount API, enabling creation, modification, and management of subaccounts along with balance, credit, and phone number transfers between them.

Yes, if you are building on the Vonage platform and need to manage subaccounts programmatically. The package is actively maintained, has low install friction, carries a permissive license, and integrates cleanly into the vonage SDK ecosystem. No known vulnerabilities. Install it as part of your vonage dependency stack when subaccount operations are part of your workflow.

## Install

pip install vonage-subaccounts
uv add vonage-subaccounts
poetry add vonage-subaccounts

## Installing vonage-subaccounts

Before you install: Low install friction with a pure-wheel distribution. Actively maintained as of 2026-07-20 with 213 repository stars. Depends on vonage-http-client, vonage-utils, and pydantic, all standard runtime dependencies.

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

Quickstart:

# Install
pip install vonage-subaccounts

# Usage (via vonage.Vonage client)
from vonage_subaccounts import SubaccountOptions

response = vonage_client.subaccounts.create_subaccount(
    SubaccountOptions(name='test', secret='1234asdfA', use_primary_account_balance=False)
)
print(response)

Requires vonage.Vonage client instance; not a standalone library. Requires Python 3.9 or later.

Verify before relying:

- Whether vonage-http-client and vonage-utils are available and maintained independently
- API rate limits or quota constraints not documented in the excerpt
- Whether all Vonage Subaccount API endpoints are covered by this package version

## Package facts

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

## Tags

vonage subaccount management, vonage api python client, subaccount creation and transfers, vonage balance transfer, vonage phone number management, vonage credit transfers, vonage sdk subaccounts, vonage-sdk, telecom-api, account-management

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