Where Developers Build for Developers

SMSPoh Inbox API (Webhook)

API Overview

The SMSPoh Inbox API allows you to receive inbound SMS messages directly into your application. When a new SMS is received by SMSPoh, our system will POST the message details to your configured webhook URL in real-time.

Webhook Request

To receive inbound SMS, you must provide SMSPoh with a secure webhook URL (HTTPS only) (e.g., https://example.com/webhook/smspoh-inbox). Our system will deliver all incoming messages to that URL in real-time.

Method: POST
Content-Type: application/json
Encoding: UTF-8

Example Payload

                    {
                    "message": "Test SMS message from user",
                    "from": "959********",
                    "to": "959*********",
                    "messageType": "sms.text",
                    "receivedAt": "2025-01-01 11:24:02"
                    }

Field Descriptions

Field	Type	Description
`message`	string	The body of the SMS message.
`from`	string	The sender’s MSISDN (phone number in international format).
`to`	string	The recipient MSISDN (your virtual number or short code).
`messageType`	string	Type of the message. Current value: `sms.text`.
`receivedAt`	string	Date and time the message was received by SMSPoh, in Myanmar Standard Time (MMT, UTC+06:30). Format: `YYYY-MM-DD HH:mm:ss`.

Webhook Response

Your endpoint must return an HTTP 200 OK status to acknowledge receipt.

🔒 Security

✅ Always provide a secure (HTTPS) webhook URL to SMSPoh.
✅ Keep your webhook URL private and do not share it publicly.
✅ You may whitelist specific SMSPoh IP ranges to restrict incoming requests.
✅ Optionally, SMSPoh can include an Authorization header in each request for authentication.