API
API

MO Push Report

In certain countries or regions, and with supported Sender IDs, the MOY Mobile international messaging platform can receive SMS replies from end users (MO messages) and push them to the customer’s server via webhook.

⚠️ MO (Mobile Originated) is not enabled by default and may incur additional charges.
The feature is only supported in specific countries and Sender IDs. In some regions, incoming messages are billed per message. Please contact support or refer to the pricing page for details.

Webhook Endpoint Configuration

Customers must configure the webhook endpoint for MO messages in the console:

Console → SMS → Settings → Push Settings → MO Webhook URL

Example:

https://your.domain.com/webhook/sms/mo

⚠️ Once configured, the URL will be cached for up to 5 minutes. Changes may take up to 5 minutes to take effect.

Request Method

  • Method: POST
  • Content-Type: application/json
  • Trigger: When an end user sends an SMS to a supported country/region or Sender ID

Request Payload Format

The platform will send the following JSON payload to your server:

{
  "messageId": "1948210789055074304",
  "from": "+1778***9779",
  "to": "+1866***1852",
  "content": "Hello.",
  "receivedAt": "2025-07-24T02:48:23"
}

Field Descriptions

Field Type Description
messageId string Unique message ID generated by the platform
from string End user's phone number (E.164 format)
to string Receiving Sender ID or virtual number (optional — may be omitted in some countries)
content string Content of the MO message sent by the end user
receivedAt string Timestamp when the platform received the message (UTC, ISO 8601 format) e.g. 2025-07-24T02:48:23

🔹 The to field is optional and may be omitted depending on carrier capabilities and country restrictions.

📞 Phone number format:
The from field uses E.164 international number format, e.g., +14155552671. This format starts with a + followed by the country code, area code, and subscriber number. No spaces or special characters.

Response Requirements

The customer server should return HTTP 200 to acknowledge successful receipt.
⚠️ The platform does not support automatic retries. Please ensure high availability of your webhook service.

Example

Sample Request from Platform

POST /webhook/sms/mo HTTP/1.1
Host: your.domain.com
Content-Type: application/json

{
  "messageId": "1948210789055074304",
  "from": "+177****9779",
  "to": "+1866****852",
  "content": "Hello.",
  "receivedAt": "2025-07-24T02:48:23"
}

Expected Response from Customer

HTTP/1.1 200 OK

Notes

  • MO is not available in all countries or regions.

  • For supported Sender IDs, destination countries, or virtual numbers, please contact support.

  • To enable this feature, please contact our technical support.

📧 Support Email: [email protected]

ON THIS Page