SMS/LMS/MMS

Domestic text sending is made up of short messages (SMS), long messages (LMS), and long messages with images (MMS).
The body fields differ by message type, and you can check the fields, requests, and responses for each below.

Send an SMS (short message)

POST/api/comm/v1/send/omni

Try sending a message Try it in the Sandbox

Use this for verification codes and short informational messages. It uses the messageFlow[].sms object, the body holds up to 90 bytes, and there is no title field.

Body Parameters

{}JSON

destinations

RequiredObject Array

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

RequiredString

The recipient number.

replaceWords

Object

The variables (JSON) used for variable substitution messages.

ref

String

The per-recipient reference field.

messageFlow

RequiredObject Array

When you add more messages, they are automatically handled in order as Failover message.

sms

RequiredObject

The SMS message information.

from

RequiredString

The sender number.

text

RequiredString

The SMS body.

ttl

String

The maximum time, in seconds, the message stays valid until it is delivered to the carrier.

originCID

String

The originating operator identification code.

paymentCode

String

The department code used for settlement.

groupKey

String

The key you set to group messages together and review their statistics in Message insight.

idempotencyKey

String

The idempotency key field that identifies a request as idempotent.

idempotencyTtl

Integer

The validity period of the idempotency key, in seconds.

ref

String

The request-level 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 processing results per recipient.

code

String

The processing code for the recipient.

result

String

The processing result for the recipient.

ref

String

The reference value you passed in 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 '{
    "destinations": [{ "to": "01000000000" }],
    "messageFlow": [{
      "sms": {
        "from": "01000000000",
        "text": "인증번호는 123456 입니다."
      }
    }],
    "ref": "sms-20260330-001"
  }'

Response example

{
  "common": {
    "authCode": "A000",
    "authResult": "Success",
    "infobankTrId": "Infobank-Tracking-Id"
  },
  "data": {
    "code": "A000",
    "result": "SUCCESS",
    "data": {
      "destinations": [{
        "to": "01000000000",
        "msgKey": "20260424104234546POM101182450000",
        "code": "A000",
        "result": "Success"
      }]
    },
    "ref": "sms-20260330-001"
  }
}

Send an LMS (long message)

POST/api/comm/v1/send/omni

Try sending a message Try it in the Sandbox

Use this for long informational text messages. It uses the messageFlow[].mms object, and the body holds up to 2,000 bytes.

Body Parameters

{}JSON

destinations

RequiredObject Array

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

RequiredString

The recipient number.

replaceWords

Object

The variables (JSON) used for variable substitution messages.

ref

String

The per-recipient reference field.

messageFlow

RequiredObject Array

When you add more messages, they are automatically handled in order as Failover message.

mms

RequiredObject

The LMS message information.

from

RequiredString

The sender number.

title

String

The LMS title.

text

RequiredString

The LMS body.

ttl

String

The maximum time, in seconds, the message stays valid until it is delivered to the carrier.

originCID

String

The originating operator identification code.

paymentCode

String

The department code used for settlement.

groupKey

String

The key you set to group messages together and review their statistics in Message insight.

idempotencyKey

String

The idempotency key field that identifies a request as idempotent.

idempotencyTtl

Integer

The validity period of the idempotency key, in seconds.

ref

String

The request-level 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 processing results per recipient.

code

String

The processing code for the recipient.

result

String

The processing result for the recipient.

ref

String

The reference value you passed in 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 '{
    "destinations": [{ "to": "01000000000" }],
    "messageFlow": [{
      "mms": {
        "from": "01000000000",
        "title": "주문 안내",
        "text": "주문이 정상 접수되었습니다. 배송은 내일부터 시작됩니다."
      }
    }],
    "ref": "lms-20260330-001"
  }'

Response example

{
  "common": {
    "authCode": "A000",
    "authResult": "Success",
    "infobankTrId": "Infobank-Tracking-Id"
  },
  "data": {
    "code": "A000",
    "result": "SUCCESS",
    "data": {
      "destinations": [{
        "to": "01000000000",
        "msgKey": "20260424104234546POM101182450000",
        "code": "A000",
        "result": "Success"
      }]
    },
    "ref": "lms-20260330-001"
  }
}

Send an MMS (image + long message)

POST/api/comm/v1/send/omni

Try sending a message Try it in the Sandbox

Use this for sends that need an image attachment. messageFlow[].mms.fileKey is required, and the body holds up to 2,000 bytes.

Body Parameters

{}JSON

destinations

RequiredObject Array

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

RequiredString

The recipient number.

replaceWords

Object

The variables (JSON) used for variable substitution messages.

ref

String

The per-recipient reference field.

messageFlow

RequiredObject Array

When you add more messages, they are automatically handled in order as Failover message.

mms

RequiredObject

The MMS message information.

from

RequiredString

The sender number.

title

String

The MMS title.

text

RequiredString

The MMS body.

fileKey

RequiredString Array

The file key issued after you upload an image. You can obtain it through Upload an image.

ttl

String

The maximum time, in seconds, the message stays valid until it is delivered to the carrier.

originCID

String

The originating operator identification code.

paymentCode

String

The department code used for settlement.

groupKey

String

The key you set to group messages together and review their statistics in Message insight.

idempotencyKey

String

The idempotency key field that identifies a request as idempotent.

idempotencyTtl

Integer

The validity period of the idempotency key, in seconds.

ref

String

The request-level 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 processing results per recipient.

code

String

The processing code for the recipient.

result

String

The processing result for the recipient.

ref

String

The reference value you passed in 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 '{
    "destinations": [{ "to": "01000000000" }],
    "messageFlow": [{
      "mms": {
        "from": "01000000000",
        "title": "프로모션 안내",
        "text": "첨부 이미지를 확인해 주세요.",
        "fileKey": ["FILE_KEY_001"]
      }
    }],
    "ref": "mms-20260330-001"
  }'

Response example

{
  "common": {
    "authCode": "A000",
    "authResult": "Success",
    "infobankTrId": "Infobank-Tracking-Id"
  },
  "data": {
    "code": "A000",
    "result": "SUCCESS",
    "data": {
      "destinations": [{
        "to": "01000000000",
        "msgKey": "20260424104234546POM101182450000",
        "code": "A000",
        "result": "Success"
      }]
    },
    "ref": "mms-20260330-001"
  }
}

Reservation send

POST/api/comm/v1/reservation

Registers an SMS/LMS/MMS message to be sent at a time you specify. resvSendTime is required. After you register a reservation, you can look it up, update, cancel, stop, or resume it, and manage its recipients on the Reservation management page.

Body Parameters

{}JSON

destinations

RequiredObject Array

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

RequiredString

The recipient number.

replaceWords

Object

The variables (JSON) used for variable substitution messages.

ref

String

The per-recipient reference field.

messageFlow

RequiredObject Array

When you add more messages, they are automatically handled in order as Failover message.

sms

Object

The message object you use for an SMS reservation send.

from

RequiredString

The sender number.

text

RequiredString

The SMS body.

ttl

String

The maximum time, in seconds, the message stays valid until it is delivered to the carrier.

originCID

String

The originating operator identification code.

mms

Object

The message object you use for an MMS reservation send.

from

RequiredString

The sender number.

title

String

The MMS title.

text

RequiredString

The MMS body.

fileKey

RequiredString Array

The file key issued after you upload an image. You can obtain it through Upload an image.

ttl

String

The maximum time, in seconds, the message stays valid until it is delivered to the carrier.

originCID

String

The originating operator identification code.

resvSendTime

RequiredString

The reservation send time.

resvName

String

The reservation name.

paymentCode

String

The department code used for settlement.

ref

String

The request-level 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": "01000000000" }],
    "messageFlow": [
      {
        "sms": {
          "from": "01000000000",
          "text": "예약 SMS 발송 테스트입니다."
        }
      },
      {
        "mms": {
          "from": "01000000000",
          "title": "예약 MMS 안내",
          "text": "예약 MMS 발송 테스트입니다.",
          "fileKey": ["FILE_KEY_001"]
        }
      }
    ],
    "resvSendTime": "2026-05-01 10:00:00",
    "resvName": "문자 예약 발송",
    "ref": "mt-resv-20260501-001"
  }'

Response example

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

Upload an image

POST/api/comm/v1/file/mms

Try it in the Sandbox

Upload an image for an MMS send and use the issued fileKey in the message body (messageFlow[].mms.fileKey). You can set up to 3 fileKey values, and the image order is not guaranteed because it depends on the carrier environment.

Body Parameters

FORM-DATA

file

RequiredBinary

The binary of the image file to upload.

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.

result

String

The processing result description.

data

Object

The actual upload response data.

fileKey

String

The file key issued after the upload.

expired

String

The file key expiration date and time (ISO 8601).

Request example

curl -X POST "https://mars.ibapi.kr/api/comm/v1/file/mms" \
  -H "Accept: application/json" \
  -H "Authorization: {ApiKey}" \
  -H "Content-Type: multipart/form-data" \
  -F "file=@/path/to/image.jpg"

Response example

{
  "common": {
    "authCode":"A000",
    "authResult":"Success",
    "infobankTrId":"header-value-X-Infobank-Tracking-Id"
  },
  "data": {
    "code":"A000",
    "result":"Success",
    "data": {
      "fileKey":"clientId_7ecbac8b4e204acc8c67d4d76e120183",
      "expired":"2027-04-24T10:45:24+09:00"
    }
  }
}