International message

International message is the channel API for sending messages to overseas recipients. Bizgo integrates with several overseas aggregators to build a send route for each country, and billing is based on acceptance regardless of whether the message actually reaches the handset.

Send an international message

POST/api/comm/v1/send/omni

Try sending a message Try it in the Sandbox

The international message send specification. It uses the messageFlow[].international object and supports a UTF-8 body. International messages are charged on acceptance, regardless of whether they actually reach the device.

Body Parameters

{}JSON

destinations

RequiredObject Array

The array of recipient information. Up to 200 per broadcast send.

RequiredString

The international recipient number.

replaceWords

Object

Variable substitution variables (JSON).

ref

String

A per-message reference field.

messageFlow

RequiredObject Array

When you add messages, they are handled in order as automatic failover messages.

international

RequiredObject

The international message object.

from

RequiredString

The sender number.

text

RequiredString

The international message body.

ttl

String

The message time-to-live in seconds.

clientSubId

String

A delimiter for specifying multiple Sender ID values and message signatures.

paymentCode

String

The department code used for settlement.

groupKey

String

A key you set to group messages and review their statistics in Message Insight.

idempotencyKey

String

The idempotency key field that identifies the request for idempotency.

idempotencyTtl

Integer

The validity period of the idempotency key.

ref

String

A per-request reference field.

Returns

common

Object

The common response section.

authCode

String

The authentication result code.

authResult

String

The authentication result message.

data

Object

The service response section.

data

Object

The actual message response data.

destinations

Object Array

The array of per-recipient results.

code

String

The per-recipient result code.

ref

String

The reference value passed with the request.

Request example

curl -X POST "https://mars.ibapi.kr/api/comm/v1/send/omni" \
  -H "Authorization: {ApiKey}" \
  -H "Content-Type: application/json" \
  -d '{
    "messageFlow": [{
      "international": {
        "from": "01000000000",
        "text": "Your verification code is 483920."
      }
    }],
    "destinations": [{
      "to": "821000000000"
    }],
    "ref": "international-20260331-001"
  }'

Response example

{
  "common": {
    "authCode": "A000",
    "authResult": "Success",
    "infobankTrId": "Infobank-Tracking-Id"
  },
  "data": {
    "code": "A000",
    "result": "Success",
    "data": {
      "destinations": [{
        "to": "821000000000",
        "msgKey": "20260424104234546POM101182450000",
        "code": "A000",
        "result": "Success"
      }]
    },
    "ref": "international-20260331-001"
  }
}

Reservation send

POST/api/comm/v1/reservation

Registers an international message to be sent at the specified time. Enter destinations[].to in E.164 format including the country code (without the +). After registering, see the Reservation management page for lookup, update, cancel, pause, resume, and recipient management.

Body Parameters

{}JSON

destinations

RequiredObject Array

The array of recipient information. Up to 200 per broadcast send.

RequiredString

The international recipient number.

ref

String

A per-message reference field.

messageFlow

RequiredObject Array

When you add messages, they are handled in order as automatic failover messages.

international

RequiredObject

The international message object.

from

RequiredString

The sender number.

text

RequiredString

The international message body.

ttl

String

The message time-to-live in seconds.

clientSubId

String

A delimiter for specifying multiple Sender ID values and message signatures.

resvSendTime

RequiredString

The reservation send time.

resvName

String

A name that identifies the reservation.

ref

String

A per-request reference field.

Returns

common

Object

The common response section.

authCode

String

The authentication result code.

authResult

String

The authentication result message.

data

Object

The reservation registration response section.

code

String

The reservation registration result code.

result

String

The reservation registration result message.

Request example

curl -X POST "https://mars.ibapi.kr/api/comm/v1/reservation" \
  -H "Authorization: {ApiKey}" \
  -H "Content-Type: application/json" \
  -d '{
    "destinations": [{
      "to": "821000000000"
    }],
    "messageFlow": [{
      "international": {
        "from": "01000000000",
        "text": "Your verification code is 483920.",
        "clientSubId": "sender-id-01"
      }
    }],
    "resvSendTime": "2026-05-01 10:00:00",
    "resvName": "국제메시지 예약 발송",
    "ref": "international-resv-20260501-001"
  }'

Response example

{
  "common": {
    "authCode": "A000",
    "authResult": "Success",
    "infobankTrId": "Infobank-Tracking-Id"
  },
  "data": {
    "code": "A000",
    "result": "Success",
    "resvKey": "20260501100000RESV0000000001"
  }
}