MO (verification/voting)
MO means an inbound message of a verification or voting nature, sent when a user replies to or participates through a specific number.
You receive MO messages at the webhook URL you registered.
Webhook
MO messages are delivered to the webhook URL you registered in advance. The actual webhook URI varies by receiving system; this document describes the POST body specification.
Header
X-IB-Timestamp
RequiredStringTimestamp of when the webhook was sent, as a Unix epoch value in milliseconds (ms), sent as a string (for example, 1743381600000). Reject requests that differ from the current time by more than 300 seconds.
X-IB-Signature
RequiredStringSecurity signature. The X-IB-Timestamp string signed with HMAC-SHA256 using the secret, then Base64-encoded (Base64(HmacSHA256(secret, X-IB-Timestamp))). Compare it with the value you compute using a constant-time comparison such as timingSafeEqual. The secret is used only for webhook verification. If you need the value for verification, ask your sales representative.
Accept
RequiredStringapplication/json.
Content-Type
RequiredStringapplication/json.
Body Parameters
{}JSONmsgKey
RequiredStringThe message key.
serviceType
RequiredStringThe service type.
msgType
RequiredStringThe message type.
to
RequiredStringThe recipient number (MO number).
from
RequiredStringThe number the MO sender entered manually (the device number by default).
carrier
RequiredStringCarrier code.
originator
RequiredStringThe device number that sent the MO.
content
RequiredStringThe MO message body content.
occurredTime
RequiredStringThe time the MO occurred.
Returns
msgKey
StringReturns the received message key as is.
Request example
curl -X POST "https://client.example.com/webhooks/mo" \ -H "Content-Type: application/json" \ -H "Accept: application/json" \ -H "X-IB-Timestamp: 1743381600000" \ -H "X-IB-Signature: {Base64(HmacSHA256(secret, X-IB-Timestamp))}" \ -d '{ "msgKey":"20260423141101437PSM949194539147", "serviceType":"MO", "msgType":"SM", "to":"#000000", "from":"0100000000", "carrier":"10001", "originator":"0100000000", "content":"그랜드 오픈!!!", "occurredTime":"2026-04-23T14:11:01+09:00" }'Response example
{ "msgKey":"20260423141101437PSM949194539147"}