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

POST{your registered webhook URL}

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

RequiredString

Timestamp of when the webhook was sent.

X-IB-Signature

RequiredString

Security signature. Generated with HmacSHA256(secret, X-IB-Timestamp). The secret is managed separately per customer account. If you need the value for verification, ask your sales representative.

Accept

RequiredString

application/json.

Content-Type

RequiredString

application/json.

Body Parameters

{}JSON

msgKey

RequiredString

The message key.

serviceType

RequiredString

The service type.

msgType

RequiredString

The message type.

to

RequiredString

The recipient number (MO number).

from

RequiredString

The number the MO sender entered manually (the device number by default).

carrier

RequiredString

Carrier code.

originator

RequiredString

The device number that sent the MO.

content

RequiredString

The MO message body content.

occurredTime

RequiredString

The time the MO occurred.

Returns

msgKey

String

Returns the received message key as is.

Request example

1curl -X POST "https://client.example.com/webhooks/mo" \
2 -H "Content-Type: application/json" \
3 -H "Accept: application/json" \
4 -H "X-IB-Timestamp: 1743381600000" \
5 -H "X-IB-Signature: {HmacSHA256(secret, X-IB-Timestamp)}" \
6 -d '{
7 "msgKey":"20260423141101437PSM949194539147",
8 "serviceType":"MO",
9 "msgType":"SM",
10 "to":"#000000",
11 "from":"0100000000",
12 "carrier":"10001",
13 "originator":"0100000000",
14 "content":"그랜드 오픈!!!",
15 "occurredTime":"2026-04-23T14:11:01+09:00"
16 }'

Response example

1{
2 "msgKey":"20260423141101437PSM949194539147"
3}