Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to Vonage

Scalekit connector
Open markdown

The Vonage connector lets your AI agent act in each user's Vonage account. Each user connects their own Vonage API key and secret once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 32 tools.

Tools
32
What they doRead · write · destructive
8 · 20 · 48 read20 write4 destructive
Users sign in with

Setup

  1. Install the SDK

    Terminal window
    npm install @scalekit-sdk/node dotenv
  2. Set your credentials

    Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

    .env
    SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
    SCALEKIT_CLIENT_ID=<your-client-id>
    SCALEKIT_CLIENT_SECRET=<your-client-secret>
  3. Create the Vonage connection

    In AgentKit > Connections, create a Vonage connection. The name you give it is the connection_name your code passes. See Configure connections.

Tools

Pass the exact name to execute_tool
Try in PlaygroundRequest a tool
  • vonage_account_balance_getGet the current balance of your Vonage account.Read-only

    Get Account Balance

    Get the current balance of your Vonage account. Returns value (balance in EUR), autoReload and the account's top-up settings. Use vonage_account_balance_get to check credit before large sends.

    Inputs

    This tool takes no inputs.

  • vonage_number_insight_basicLook up basic, free information about a phone number with Vonage Number Insight: its international and national formats and country.Read-only

    Get Basic Number Insight

    Look up basic, free information about a phone number with Vonage Number Insight: its international and national formats and country. Returns status, international_format_number, national_format_number, country_code, country_name and country_prefix. Use vonage_number_insight_basic to normalise or validate a number for free. Use vonage_number_insight_standard or vonage_number_insight_advanced for carrier, porting and reachability data.

    Inputs

    numberstringrequired
    Phone number in national or international format. Example: 447700900000
    countrystring
    ISO 3166-1 alpha-2 country code, needed when number is in national format. Example: GB
  • vonage_numbers_listList the virtual phone numbers your Vonage account owns.Read-only

    List Owned Numbers

    List the virtual phone numbers your Vonage account owns. Returns count and numbers with msisdn, country, type, features and the linked application. Use vonage_numbers_list to find your sender numbers. Use vonage_numbers_search to find new numbers to buy.

    Inputs

    application_idstring
    Only numbers linked to this Vonage application ID. Example: aaaaaaaa-bbbb-4ccc-8ddd-0123456789ab
    countrystring
    Only numbers from this ISO 3166-1 alpha-2 country. Example: GB
    has_applicationboolean
    true for numbers linked to any application, false for numbers not linked to one. Example: true
    indexinteger
    Page index, starting at 1. Example: 1
    patternstring
    Digits to match; use with search_pattern. Example: 7700
    search_patterninteger
    How pattern matches: 0 starts with, 1 contains, 2 ends with. Example: 1one of 012
    sizeinteger
    Numbers per page, up to 100. Defaults to 10. Example: 50
  • vonage_verify_template_fragment_getGet one text fragment of a Vonage Verify v2 template.Read-only

    Get Verify Template Fragment

    Get one text fragment of a Vonage Verify v2 template. Returns template_fragment_id, channel, locale, text and timestamps. Use vonage_verify_template_fragment_get for one fragment. Use vonage_verify_template_fragments_list to browse a template's fragments.

    Inputs

    template_fragment_idstringrequired
    Template fragment UUID. Example: c70f446e-997a-4313-a081-60a02a31dc19
    template_idstringrequired
    Template UUID. Example: 8f35a1a7-eb2f-4552-8fdf-fffdaee41bc9
  • vonage_verify_template_fragments_listList the per-channel, per-language texts (fragments) of a Vonage Verify v2 template.Read-only

    List Verify Template Fragments

    List the per-channel, per-language texts (fragments) of a Vonage Verify v2 template. Returns fragments with template_fragment_id, channel, locale and text. Use vonage_verify_template_fragments_list to see a template's wording. Use vonage_verify_template_fragment_get for one fragment.

    Inputs

    template_idstringrequired
    Template UUID. Example: 8f35a1a7-eb2f-4552-8fdf-fffdaee41bc9
    pageinteger
    Page number, starting at 1. Example: 1
    page_sizeinteger
    Fragments per page, 1 to 100. Defaults to 10. Example: 20
  • vonage_verify_template_getGet one Vonage Verify v2 custom template by ID.Read-only

    Get Verify Template

    Get one Vonage Verify v2 custom template by ID. Returns template_id, name and is_default. Use vonage_verify_template_get for one template. Use vonage_verify_templates_list to browse.

    Inputs

    template_idstringrequired
    Template UUID. Example: 8f35a1a7-eb2f-4552-8fdf-fffdaee41bc9
  • vonage_verify_templates_listList the custom message templates in your Vonage Verify v2 account.Read-only

    List Verify Templates

    List the custom message templates in your Vonage Verify v2 account. Returns templates with template_id, name and is_default, plus paging links. Use vonage_verify_templates_list to find a template_id. Use vonage_verify_template_get for one template.

    Inputs

    pageinteger
    Page number, starting at 1. Example: 1
    page_sizeinteger
    Templates per page, 1 to 100. Defaults to 10. Example: 20