SMS API

The APEX Messaging SMS API allows you to send and receive SMS messages globally using a simple HTTP interface. It is designed for reliability, speed, and ease of integration at any scale.

Endpoint

https://papi.apex-messaging.com/SendSmsV2

Authentication

Authentication is handled using your API key and the corresponding whitelisted IPs

Your API key must be included with every request using the apiToken parameter.

API keys are created and managed from the APEX Dashboard under Manage API.
IP whitelisting is required for all API keys.

Sending an SMS

The API supports two request formats:

– GET requests using URL query parameters
– POST requests using JSON payloads

Both methods use the same base URL and API Key.

Option 1: GET Request (URL Parameters)

Useful for testing or simple integrations.

GET https://papi.apex-messaging.com/SendSmsV2
  ?apiToken=YOUR_API_KEY
  &messageType=1
  &messageEncoding=1
  &destinationAddress=35699384535
  &sourceAddress=SENDER1
  &messageText=Hello
  &callBackUrl=https://webhook.site/DLRS
  &userReferenceId=123ABC

Option 2: POST Request (JSON Payload)

Recommended for production environments.

Endpoint

POST https://papi.apex-messaging.com/SendSmsV2

Request body

[
  {
    "apiToken": "YOUR_API_KEY",
    "messageType": "1",
    "messageEncoding": "1",
    "destinationAddress": "35699999999",
    "sourceAddress": "ABCBank",
    "messageText": "Hello",
    "callBackUrl": "https://webhook.site/DLRS",
    "userReferenceId": "123ABC"
  }
]

Parameters

Parameter	Description	Notes
apiToken*	Your API authentication key
destinationAddress*	Recipient phone number in international format
sourceAddress*	Sender ID or originating number
messageText*	Message content
messageType*		1 = Promotional 2 = Tranactional 3 = OTP
messageEncoding*	Character Encoding used for the message	0 = default (GSM) 1 = ascii 2 = Octet 3 = Latin1 4 = Octet Unspecified 6 = Cyrillic 7 = Latin Hebrew 8 = UCS2
callBackUrl	URL to receive delivery receipts (DLRs)
userReferenceId	Optional reference for your own tracking