Skip to content

On a schedule

Get warned when Vonage credit runs low

I hear about a low balance before my texts stop sending.

Runs
On a schedule
Apps
Vonage
AI
Not needed
Access
API key/secret

Send this to your assistant

Create a ClickRuntime automation: every morning at 9, check my Vonage account balance and email me if it's below $10.

Paste it into your assistant. It tells you what it will send or change before it runs live.

First time? Adding ClickRuntime to your assistant takes about two minutes.

Why use it

Why teams use this automation

Vonage SMS is prepaid for many accounts, and when the balance reaches zero messages stop sending without a loud warning. A clinic's appointment reminders silently fail over a weekend, a two-factor login text never arrives, and customers get locked out. By the time someone notices, dozens of messages were dropped and the incident is hard to untangle.

On a schedule you pick, the automation reads your current Vonage account balance, compares it to a threshold you set, and sends an alert if you are below it. It tells you the balance and the threshold so you can top up the same day, well before the next batch of texts is due.

It matters for any business where SMS is part of an operation, such as verification codes, delivery updates or reminders, rather than an occasional convenience.

What you get out of it

  • Top up before messages fail

    A warning at, say, 20 euros gives you days of runway. A zero balance gives you angry customers and a retroactive search through logs for the messages that were never delivered and now need resending.

  • Protects login and verification flows

    If your app texts one-time codes, an empty balance stops users from signing in at all. The alert keeps a billing detail from becoming a customer-facing outage that shows up as support tickets and lost sessions.

  • Predictable spending

    Seeing the balance fall at regular checks helps you notice a sudden drop that could mean a runaway loop or abuse of your SMS endpoint, long before the costs add up to something that would be painful to explain.

  • No one has to remember to look

    Account balance is easy to forget when everything is working. An automatic check replaces a recurring chore nobody wants, and it does not fail when the person who used to check it is on leave.

  • Gives finance a heads up

    The alert can go to whoever approves the top-up, so the payment is already waiting when the account needs it, instead of being raised as an urgent request on the one day the messages stop.

How it works

What happens, step by step

  1. On the schedule you set, ClickRuntime checks your Vonage account balance.

  2. It compares the balance with the minimum you chose.

  3. If it's below, you get an email with the balance and a link to top up, before your texts stop sending.

Before it runs live

  • Connect Vonage

What you get

RunsOn a schedule
Get warned when Vonage credit runs lowtoday, 9:00Succeeded
Email · Vonage balance is 7.84Your Vonage balance is 7.84, below 10.00. Top up at https://dashboard.nexmo.com/billing-and-payments

Build your own

Need it to work differently?

This template is a starting point. Copy the prompt and change it, or describe a different automation from scratch, with your own conditions, more apps or an AI step. Your assistant writes it, tests it and runs it on ClickRuntime.
  • Your own rules

    Conditions, thresholds, filters and exceptions, written the way you'd explain them to a colleague.

  • Any number of apps

    One automation can read from one app and update several others. Over 248 apps are ready, and anything with an API works too.

  • AI where it helps

    Summaries, classification, extraction and drafts use ClickRuntime's built-in AI, with no extra key.

  • On a schedule or on each event

    Runs as often as every 5 minutes, or the moment an app sends an event, and keeps track of what it already handled.

Changes you can ask for

  • Run it at a different time, more or less often, or only on weekdays
  • Add an AI step, for example to summarize, sort or draft a reply
  • Add another app, for example also send it to Slack
  • Combine it with other Vonage steps into one automation

Under the hood

The code that runs this automation

This is the Python script that runs each time the automation starts. Your AI assistant writes it for you when you send the prompt, and you allow each step in your assistant. To change how the automation works, describe the change to your assistant and it updates the script for you. For every function it can use, see the script reference.
low_balance_alert_vonage.pyexample
from clickruntime import on_trigger, credentials, http, notify

MIN_BALANCE = 10.0

@on_trigger
def run(event):
    resp = http.get("https://rest.nexmo.com/account/get-balance", params={
        "api_key": credentials.secret("VONAGE_API_KEY"), "api_secret": credentials.secret("VONAGE_API_SECRET")})
    resp.raise_for_status()
    balance = resp.json()["value"]
    if balance < MIN_BALANCE:
        notify.email_me(f"Vonage balance is {balance:.2f}", f"Your Vonage balance is {balance:.2f}, below {MIN_BALANCE:.2f}. "
                        "Top up at https://dashboard.nexmo.com/billing-and-payments")
    return {"balance": balance}

FAQ

Common questions

How often should the balance check run?
Daily is enough for most accounts. If you send thousands of messages a day, an hourly check gives more warning. The schedule is part of the setup and can be set to whatever fits your sending volume.
Does it work with accounts on auto-reload?
It still reads the balance, so you would see an alert only if the balance falls under your threshold despite auto-reload, which can reveal a failed payment method or an expired card. That makes it a useful backstop.
What threshold should I choose?
Pick an amount that covers a few days of your normal sending. If you spend about 5 a day, a threshold of 25 gives roughly five days to react. You can adjust the number after watching a few weeks of real usage.
What permissions does it need?
API key/secret. Nothing else in your accounts is used.
Does it need AI?
No. It runs without AI, so it doesn't use your plan's AI allowance.
How many runs does it use?
One run each time it runs (on a schedule). Checks that find nothing to do and stop right away aren't counted.
Can I change how it works?
Yes. Describe the change to your AI assistant, for example a different schedule, channel or filter. It updates the automation, tests it and tells you what changed.

Set up “Get warned when Vonage credit runs low” from your assistant

Copy the prompt above, or connect your assistant first. Free plan, no credit card.