Migration guide

How to migrate from TextBolt to Vonage

A developer's guide to moving SMS sending from TextBolt's email-to-SMS gateway to Vonage's REST communications APIs, with field mapping and a migration checklist.

TextBolt is an email-to-SMS gateway: US and Canadian businesses send and receive text messages by addressing an email to a phone-number address, with no REST API. Vonage is a communications-API platform (part of Ericsson) that exposes SMS, voice, and multichannel messaging over REST. On the messaging.dev Score, TextBolt rates 17/100 and Vonage 89/100; this guide covers what actually changes when you re-point your sending code.

What you gain and what you lose

Channels. TextBolt supports SMS only. Vonage keeps SMS and adds MMS, RCS, WhatsApp, Viber, Facebook Messenger, and voice, so you lose no channel and gain five messaging channels plus voice. Neither provider offers Telegram, Apple Messages for Business, or email, so those stay unavailable.

Compliance. TextBolt lists no certifications. Vonage is GDPR, ISO 27001, SOC 2, and HIPAA aligned, so every compliance dimension moves in your favor.

Data residency. TextBolt runs on US servers only, with no region choice. Vonage offers both US and EU servers, a data-residency choice, and additional APAC and Australia regions.

Pricing. TextBolt bills monthly subscription plans ($29–$99 plus custom Enterprise) with an included SMS-credit allowance and per-segment overage, starting around $0.030 per US/Canada segment. Vonage is pay-as-you-go per message with volume discounts, starting near $0.0072 per US segment plus carrier fees, a different budgeting model.

Tooling. Vonage adds a €2 free trial credit (TextBolt has none), official SDKs for Node.js, Python, PHP, Java, C#, Ruby, and Kotlin (TextBolt ships none), a sandbox test environment (TextBolt has none), and high-quality docs versus TextBolt’s thinner documentation. Coverage widens from 2 countries to roughly 200.

How the request format differs

TextBolt (SMTP email gateway):

curl --ssl-reqd --url 'smtps://smtp.gmail.com:465' \
  --user '[email protected]:GMAIL_APP_PASSWORD' \
  --mail-from '[email protected]' \
  --mail-rcpt '[email protected]' \
  -T <(printf 'Subject: \r\n\r\nYour appointment is confirmed for tomorrow at 3 PM.\r\n')

Vonage (REST SMS API):

curl -X POST 'https://rest.nexmo.com/sms/json' \
  -d 'api_key=YOUR_API_KEY' \
  -d 'api_secret=YOUR_API_SECRET' \
  -d 'from=Vonage' \
  -d 'to=15551234567' \
  -d 'text=Hello from Vonage'

The transport changes completely. TextBolt has no REST API: you submit through an SMTP server (smtps://smtp.gmail.com:465) and address the recipient as {E.164-without-plus}@sendemailtotext.com. Vonage is an HTTPS POST to https://rest.nexmo.com/sms/json (legacy SMS API) or https://api.nexmo.com/v1/messages (Messages API).

Authentication changes too. TextBolt has no API keys; you authenticate by sending from an email address registered and verified with your account (business/A2P 10DLC verification required). Vonage uses an API Key + API Secret for the SMS API, or JWT auth for the Messages API.

Field mapping is straightforward: the recipient --mail-rcpt '[email protected]' becomes to=15551234567; the sender --mail-from '[email protected]' becomes from=Vonage (an alphanumeric sender ID or number); the message body from the printf payload becomes text=...; and the SMTP --user email:password credentials become api_key/api_secret.

Migration checklist

  1. Create a Vonage account and generate your API Key + API Secret (or a JWT/application for the Messages API). See how to start with Vonage.
  2. Map the request fields (recipient → to, sender → from, body → text) and pick the SMS API or Messages API.
  3. Re-point your sending code from SMTP submission to an HTTPS POST against the Vonage endpoint.
  4. Re-test in Vonage’s sandbox before sending live traffic.
  5. Update delivery handling: replace TextBolt’s Twilio-based status callbacks with Vonage delivery-receipt webhooks.
  6. Run both paths in parallel and reconcile delivery.
  7. Cut over once Vonage matches or beats your baseline.

Watch out for

  • More auth setup. You move from “send from a verified email, no keys” to managing an API Key/Secret or JWT; store them as secrets.
  • Two APIs, two auth models. Choose deliberately between the legacy SMS API (key + secret) and the Messages API (JWT); base URLs and auth differ.
  • Pricing model flip. Predictable monthly plans become per-message pay-as-you-go plus carrier fees; model your volume before cutover.
  • Still no Telegram, Apple Messages for Business, or email. If you need those channels, Vonage does not add them.

For a full side-by-side, see TextBolt vs Vonage.