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
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_urlon 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/SenderIDStatusand/api/GetSenderIDList - Two-way
- Replies to a two-way number appear under the inbox's 2-Way SMS tab
- Pricing
/api/CalculateSmsPriceup front,/api/CheckBalancefor the wallet- Records
- Message history with CSV export
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.