HollaTags API
  • Introduction
  • 📳SMS
    • Send
    • Receive
    • Status
    • Credit
    • Lookup
    • Send SMS Sample Code
    • Receive SMS Sample Code
    • API Response
    • Callback
    • OTP
    • SMS DLR Error Codes
  • 📳USSD
    • USSD Inbound
    • USSD Outbound
    • USSD Sample Code
    • USSD Error Codes
  • 📳WhatsApp
    • WhatsApp Chat
    • WhatsApp Push
    • WhatsApp Sample Code
  • 📳SMPP
    • SMPP Specification
    • SMPP Servers
    • SMPP Authentication
    • SMPP Configuration
    • SMPP Message PDU
    • SMPP Client Configuration
    • SMPP Response Codes
    • SMPP DLR Codes
  • 💳Airtime
    • Airtime (VTU)
  • ❓FAQ
    • USSD - Dedicated
    • USSD - Shared
Powered by GitBook
On this page

Was this helpful?

  1. SMS

Send

PreviousIntroductionNextReceive

Last updated 3 years ago

Was this helpful?

Send

POST https://sms.hollatags.com/api/send

This endpoint allows you to send SMS Message

The POST parameters should be sent as x-www-form-urlencoded

Request Body

Name
Type
Description

user*

string

Account username

pass*

string

Account password

from*

string

SMS SenderID must be <= 11 chars for alphanumerical must be <= 16 chars for numerical

to*

string

Destination number(s) (must be in international format and no prefix e.g 2348030000000) Separate with comma if you are sending to multiple recipients (e.g 234805*,234803*) The maximum limit on the API is currently 500 numbers for a single API call.

msg*

string

SMS Message Content (Must be <=905 chars)

type

integer

Message Format 0 = Normal SMS 1 = Flash SMS 2 = Unicode SMS (Arabic, Chinese etc)

callback_url

string

If specified, sms status notifications would be sent to this URL by HTTP POST. You can include paths in the url but all query parameters are ignored. See for a full list of message status parameters that will be sent back to your url.

enable_msg_id

boolean

If TRUE, the API response will contain a unique message_id for your sms. Sample response 2348030000000, 24137cf8-eccc-469c-80af-109538857e53 Tilde (~) will be used to separate multiple destination numbers. e.g 2348030000000, 42138969-09f9-434d-a3c6-db5733fba736~2348030000011,974790b3-e598-41a8-939b-772d16860fb4

message_uuid

string

This serves as the idempotency unique client message reference ID for safely retrying failed or timeout requests without accidentally executing the same transaction twice.

(automatically expire after 30days) (Length is 24 to 64 characters )

We suggest the reference ID should be a V4 UUIDs (e.g 58c0d0f9-7dc6-4ce0-91ae-2d84c5880713), or another random string that can guarantee uniqueness to avoid collisions.

sent
23448030000000,24137cf8-eccc-469c-80af-109538857e53
📳
https://docs.hollatags.com/send/callback