vapio
get in touch

Welcome to Vapio’s Developer Portal

Access powerful communication tools and integrate them seamlessly into your applications. Whether you're building a customer support system, a marketing automation tool, or a real-time communication solution, Vapio provides the APIs and resources you need to get started quickly and scale your business.

SMS API

Introduction

Vapio SMS API Endpoint

VAPIO has an HTTP SMS service designed to let end-users send SMS messages using an HTTP interface. The API supports custom UDH, message scheduling, and other advanced features including Unicode formats.

Character Set Support

Supports GSM and Unicode (UTF-8 & Unicode-16 Big-Endian).

Message Length

  • Standard Latin: 160 characters
  • Unicode: 70 characters
  • Binary: 140 characters (including UDH)
  • Use UDH for long messages (see Smart Messaging Guide)

Authorizations

  • Use a valid API Key
  • Only HTTPS is accepted
  • Responses in JSON
  • Errors return JSON with error keys

Rate Limit

Abide by rate limits to avoid blocks or restrictions.

Get Started

Base URL:
https://sms.vapio.io/api.php?

Example GET Request:
https://sms.vapio.io/api.php?username=abc&apikey=dOIni1jnnMFT&senderid=senderid&route=route_name&mobile=mobile_number&text=message

Curl Request:

curl -X POST \
'https://vapio.in/api.php' \
-d 'username=your username' \
-d 'apikey=your api key' \
-d 'senderid=your sender id' \
-d 'route=Route which is assigned to you' \
-d 'mobile=xxxxxxxxxx' \
-d 'format=json' \
-d 'TID=Template ID' \
-d 'text=Message Text'

API Parameters

Parameter Type Description
usernameMandatoryYour account username.
apikeyMandatoryYour API key from Vapio.
senderidMandatoryDLT-approved sender name (6 characters).
routeMandatoryAssigned route (e.g., TRANS, PROMO, OTP).
mobileMandatoryRecipient number(s), comma-separated.
textMandatoryMessage text (DLT-approved).
formatOptionalResponse format: html/json/xml.
msgtypeOptionalUse 'unicode' for other languages.
groupOptionalName of your contact group.
TIDOptionalDLT-approved template ID.
PEIDOptionalDLT-approved PEID.
scheduleOptionalSchedule time in dd/mm/YYYY hh:mm:ss format.

API Responses

  • Message Submitted Successfully: Message sent to the operator.
  • Provide username and API key: Fields are empty.
  • Invalid username and API Key: Wrong credentials.
  • Sender ID Wrong!!: Invalid or unauthorized sender ID.
  • Undefined Route: Incorrect route.
  • Invalid Mobile Number: Format issue or missing country code.
  • Template Mismatch!!: Message not approved for your account.
  • No contacts available in this group: Empty group.
  • Please Assign Mobile Number: Recipient number missing.
  • Routing failed: Error in routing.
  • Provide Route: Route not provided.
  • Text Should not be an empty: Message text is missing.
  • Please check schedule date & time: Schedule is invalid or in the past.
  • less balance /insufficient credits: Low credit balance.
  • sender id cannot be blank: Sender ID missing.

vapio