VEverihubs
SMS Notifications and Promotions

Send SMS V2

Changed on

SMS OTP version change is by introducing a new API version release.<br>

Version changes usually need to be applied immediately to the latest version, in order to get a better API usage experience than the previous version.<br>

The benefits you get if you use a newer version are as follows.

  • Decreasing processing time in API Request and Response
  • Improve feature in SMS: Blocking Request, Spam Check, Sequential Phone Number, and Blocked Numbers
  • Increase RPS in SMS (before 30rps to 50rps)
  • Better developer environment to support future developments
  • Improve logging and monitoring on our side
  • Improved dependencies and improved service stability<br>

This method helps you to send sms containing desired text to destination number<br> Rate limit of 50 RPS is applied to SMS service. Verihubs also apply rate limit divided into several categories based on product. More explanation link<br>

Callback Description

When you want to use callback_url payload, you only need to put for example

your-callback-url.com/callback

Example callback that we'll send

your-callback-url.com/callback?session_id=d0f5fb5c-2d50-4d3f-aea7-20018ab15806&status=1
PayloadDescription
session_idID of the specific message
statusLatest status of the request

Status Description

StatusNameDescription
0RequestedSMS has been requested.
1DeliveredSMS has been delivered to destination number. This status will be charged.
4FailedOperator cannot send SMS to destination number
5Request ErrorVerihubs cannot reach Operator
6RejectedRequest rejected due to Too Many Requests
7UndeliveredSMS has not been delivered to destination number (response received from Operator). This status will be charged.
8No Delivery ReportDelivered without Delivery Report from operator after certain period. This status will be charged.
9BlockedDestination Number has been blocked by Verihubs's system
post/v2/sms/send

Request

  • Base URL
    https://api.verihubs.com
  • URL
    https://api.verihubs.com/v2/sms/send
  • Auth
    none declared. Required headers: App-ID, API-Key

Headers

App-IDstring required
API-Keystring required

Request body

msisdnstring required

Destination Phone Number. You need to include the international prefix number and also find your local prefix number here.

textstring required

SMS Body. In the SMS Body, you must mention the brand name according to the Sender ID.

premiumboolean

used for Transactional SMS (Text Message from Business to Customer that provides valuable information about their product, service or processes).

callback_urlstring

Optional. This URL will be called by the server when the desired event will occur. Callback will work if you use premium route

Example request

{
  "msisdn": "62839102839",
  "text": "This is text example",
  "premium": true,
  "callback_url": "https://your-url-callback.com"
}

Response

Successful Response

messagestring required

Message

msisdnunknown required
session_idstring required

Generated ID which associated with verification request.

segment_countinteger

Segment Count is the number of SMS segmentation which is calculated by the GSM-7 and UTF-16 encoding system based on the SMS content sent. This segment count becomes a reference for calculating the cost of using SMS services. More explanation link

Example response

{
  "message": "SMS sent successfully",
  "msisdn": 628212312533,
  "session_id": "asddede-asdae234-34sfd3-fe234d",
  "segment_count": 2
}

Changes