VeloConnect — home Get started
Get started

SMS

Transactional, promotional and verification SMS from registered sender IDs — one API call to send, delivery reports posted to your own URL, and the price available before you commit.

One endpoint

Send one message or many, the same way

POST /api/SendSMS sends to a number; SendSMSMulti takes several. Both authenticate with your API ID (api_id) and return a message_id along with the cost of what was sent.

  • Unicode text — Armenian, Cyrillic, emoji — detected from the message itself
  • A validity period per message, so a time-sensitive code expires instead of arriving late
  • Delivery reports posted to your callback_url, per message
  • CalculateSmsPrice and CheckBalance before you commit to a send

Read the SMS API docs

SMS at a glance

Sender ID rules, lead times and per-country restrictions are set by each operator, not by us. Ask us for the current position on a country before you plan a launch around it.

Send
POST /api/SendSMS · POST /api/SendSMSMulti
Authentication
Your API ID as api_id, in the JSON body or the query string
Templates
Send a saved template by templateid, with up to five variables (V1–V5)
Unicode
Detected from the text; the number of message parts follows from it
Delivery reports
callback_url on SendSMS, plus stored message records
Your reference
uid — returned with the response and the delivery report
Validity period
ValidityPeriodInSeconds, two days unless you set it
Sender IDs
Registered before use; check with /api/SenderIDStatus and /api/GetSenderIDList
Two-way
Replies to a two-way number appear under the inbox's 2-Way SMS tab
Pricing
/api/CalculateSmsPrice up front, /api/CheckBalance for the wallet
Records
Message history with CSV export

For developers

Your first SMS

An API ID, a registered sender ID and one request.

Full API reference

curl -X POST https://api.veloconnect.me/api/SendSMS \
  -H "Content-Type: application/json" \
  -d '{
    "api_id": "YOUR_API_ID",
    "phonenumber": "37412345678",
    "sender_id": "VeloConnect",
    "sms_type": "T",
    "textmessage": "Your verification code is 482913",
    "callback_url": "https://example.com/hooks/dlr"
  }'
import os, requests

r = requests.post(
    "https://api.veloconnect.me/api/SendSMS",
    json={
        "api_id": os.environ["VELO_API_ID"],
        "phonenumber": "37412345678",
        "sender_id": "VeloConnect",
        "sms_type": "T",
        "textmessage": "Your verification code is 482913",
    },
    timeout=15,
)
print(r.json()["message_id"])
const res = await fetch(
  "https://api.veloconnect.me/api/SendSMS",
  {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({
      api_id: process.env.VELO_API_ID,
      phonenumber: "37412345678",
      sender_id: "VeloConnect",
      sms_type: "T",
      textmessage: "Your verification code is 482913",
    }),
  }
);
const { message_id } = await res.json();

What comes with it

Everything around the send

  • Sender ID registration

    Register sender IDs and track their approval status from the dashboard or the API.

  • Multi-channel campaigns

    Put SMS after Viber or WhatsApp in a campaign, and the recipients those channels cannot be used for get the SMS.

  • Short links with attribution

    Shorten campaign URLs and see clicks attributed back to the campaign and the recipient.

  • Contacts and segments

    One contact record per customer, and segments you add contacts to and remove them from.

  • Two-way conversations

    Replies to a two-way number arrive under the inbox’s 2-Way SMS tab, not as a dead end.

  • Records and exports

    Query message history and export it to CSV for finance or reconciliation.

SMS questions

Can I use my brand name as the sender?

Yes, where the destination country allows it. Sender IDs are registered before use, and each operator sets its own rules and lead times. You can check the state of a registration through /api/SenderIDStatus or in the dashboard.

How do I know a message actually arrived?

Pass a callback_url to SendSMS and the delivery report is posted to it as JSON. Every message is also stored as a record you can query or export, so you are not dependent on catching that one request.

What happens to Armenian characters?

Write the text as it is. Unicode is detected from the message, and because a Unicode part holds fewer characters, the part count — and so the price — follows from it. /api/CalculateSmsPrice shows the cost before you send, and the SMS length calculator shows how a message splits as you type it.

Can customers reply?

Yes, on a two-way SMS number. Replies appear in the inbox under the 2-Way SMS tab, next to WhatsApp, Viber, Facebook and Instagram.

What if SMS is not the right channel for someone?

In a campaign you set the channel order, and it runs per recipient: a recipient moves to the next channel when the current one cannot be used for them — no identity for that channel on the contact, or a failed send. A message a channel has accepted is not sent again elsewhere.

Send your first SMS today

Create an account, register a sender ID and send from the dashboard or the API.