> ## Documentation Index
> Fetch the complete documentation index at: https://docs.atako.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Vonage

> Connect Vonage to your Atako agents — 4 read and 1 write actions.

Let your agents send SMS, check the account balance and SMS prices, and list or search phone numbers on your Vonage (formerly Nexmo) account.

## Connection

* **Authentication**: API key (API key:API secret).

<Note>
  Vonage API Dashboard (dashboard.nexmo.com) → API Settings → copy the API key (8 characters) and the API secret. You can also create a second secret on the same page (an account holds up to two) and use it for Atako. Paste both joined by a colon: APIKEY:APISECRET. The credential has full account access — no scopes to configure.

  See [Vonage's documentation](https://dashboard.nexmo.com/settings).
</Note>

## Read actions (4)

| Action                     | Description                                                                                                                                                   |
| -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `get_balance`              | Get the current balance of the Vonage account (in EUR) and whether auto-reload is on — the cheapest call to check that the credential works.                  |
| `get_sms_pricing`          | Get the outbound SMS price for one destination country, per mobile network, as billed to this account.                                                        |
| `list_numbers`             | List the virtual phone numbers owned by the account (number, country, type, features, linked application), optionally filtered.                               |
| `search_available_numbers` | Search the numbers available to rent in a country (read-only — buying a number is not exposed). Returns each number with its type, features and monthly cost. |

## Write actions (1)

| Action     | Description                                                                                                                                                                                                                                                                                    |
| ---------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `send_sms` | Send an SMS (billed by Vonage per message part). `to` is E.164 without "+" (e.g. 447700900000). A non-zero status in the answer (e.g. 4 = bad credentials, 9 = partner quota violation, i.e. insufficient credit, 29 = non-whitelisted destination on a demo account) is reported as an error. |

## Permissions

Every action above must be explicitly granted to an agent before it can be used. See [Permissions](/integrations/permissions) for the grant model and [Security](/integrations/security) for how credentials are protected.

***

*Last reviewed against the provider API: September 2026.*