API ReferenceCommunication APIKakao Biz Message

Kakao Biz Message (common)

The Kakao Biz Message common APIs let you look up and manage the sender profiles and operational status that Alimtalk, Brand Message, and CS Talk all share.

Channel authentication and sender profile registration

Request a Kakao channel authentication token with your API key, then use the authenticated token to register a sender profile or look up channel information by uuid or senderKey.

Request a Kakao channel authentication token

This API requests the KakaoTalk channel authentication token needed to register a sender profile. If the KakaoTalk account linked to the phone number you enter has not blocked the KakaoTalk channel, an authentication token is sent, and you use that token when you register the sender profile. The authenticated token is kept on the Biz Message Center server for 7 days.

POST/api/comm/v1/account/kakao/sender/token

Requests a KakaoTalk channel authentication token for registering a sender profile. If the KakaoTalk account linked to the phone number you enter has not blocked the channel, an authentication token is sent, and you use it when registering the sender profile. The verified token is kept on the Biz Message Center server for 7 days.

Body Parameters

yellowId

RequiredString

The KakaoTalk channel ID. (ex: @bizgo).

phoneNumber

RequiredString

The phone number of the administrator who receives KakaoTalk channel notifications.

Returns

common

Object

The common response section.

data

Object

The service response section.

Request example

curl -X POST "https://mars.ibapi.kr/api/comm/v1/account/kakao/sender/token" \
  -H "Content-Type: application/json" \
  -H "Authorization: {ApiKey}" \
  -d '{
  "yellowId": "{yellowId}",
  "phoneNumber": "{phoneNumber}"
}'

Response example

{
  "common": {
    "authCode":"A000",
    "infobankTrId":"M-260724133159324PRD25892",
    "authResult":"SUCCESS"
  },
  "data": {
    "code":"A000",
    "result":"SUCCESS",
    "resultMsg":"요청 성공"
  }
}

Register a sender profile with an authentication token

This registers a KakaoTalk channel as a new sender profile.

You need a KakaoTalk channel that has passed business verification in the Kakao Business Partner Center, and the profile must be in the activated state and not blocked by an operator. You request sender profile registration with the token you received from the KakaoTalk channel authentication token request and the phone number you requested the token for. You can check which category codes are available with the lookup of all sender profile categories.

If the KakaoTalk channel you request is already registered at the request of another hub partner, it is registered with the category code of the previously registered sender profile. A sender profile that uses Brand Message can set a toll-free opt-out phone number (verification number). (Required when you use targeting M or N for message sends.)

POST/api/comm/v1/account/kakao/sender

Registers a KakaoTalk channel as a new sender profile. The channel must be business-verified in the Kakao Business Partner Center, have an activated profile, and not be blocked by an operator. Submit the registration with the token from the authentication token request and the phone number you used for that request.

Header Parameters

token

RequiredString

The channel authentication token value.

phoneNumber

RequiredString

The administrator's phone number.

Body Parameters

yellowId

RequiredString

The KakaoTalk channel to register.

categoryCode

RequiredString

The category code (an 11-digit number).

unsubscribePhoneNumber

String

The toll-free opt-out phone number.

unsubscribeAuthNumber

String

The toll-free opt-out verification code. (ex: 12345).

bizchat

Boolean

(CS Talk only) Whether CS Talk is enabled.

committalCompanyName

String

(CS Talk only) The name of the company the support content is outsourced to.

channelKey

String

The channel that receives message send results.

Returns

common

Object

The common response section.

data

Object

The service response section.

kakao

Object

The Kakao response section.

senderProfile

Object

The sender profile information.

profileStatus

String

The KakaoTalk channel status.

brandMessage

Boolean

Whether Brand Message targeting is used.

profileSpamLevel

String

The KakaoTalk channel spam status.

profileMessageSpamLevel

String

The KakaoTalk message spam status.

Request example

curl -X POST "https://mars.ibapi.kr/api/comm/v1/account/kakao/sender" \
  -H "token: {token}" \
  -H "phoneNumber: {phoneNumber}" \
  -H "Content-Type: application/json" \
  -H "Authorization: {ApiKey}" \
  -d '{
  "yellowId": "{yellowId}",
  "categoryCode": "{categoryCode}",
  "unsubscribePhoneNumber": "{unsubscribePhoneNumber}",
  "unsubscribeAuthNumber": "{unsubscribeAuthNumber}",
  "bizchat": "{bizchat}",
  "committalCompanyName": "{committalCompanyName}",
  "channelKey": "{channelKey}"
}'

Response example

{
  "common": {
    "authCode":"A000",
    "infobankTrId":"M-260724133217180PRD26415",
    "authResult":"SUCCESS"
  },
  "data": {
    "code":"A000",
    "result":"SUCCESS",
    "resultMsg":"요청 성공",
    "kakao": {
      "senderProfile": {
        "senderKey":"{senderKey}",
        "uuid":"@bizgo",
        "name":"비즈고",
        "status":"A",
        "block": false,
        "dormant": false,
        "profileStatus":"A",
        "createdAt":"2026-07-24 13:32:17",
        "modifiedAt":"2026-07-24 13:32:18",
        "categoryCode":"00000000001",
        "brandtalk": false,
        "brandMessage": false,
        "channelKey":"base",
        "businessProfile": true,
        "businessType":"BUSINESS",
        "unsubscribePhoneNumber":"080-1111-2222",
        "unsubscribeAuthNumber":"12345",
        "profileSpamLevel":"정상",
        "profileMessageSpamLevel":"정상",
        "clearBlockUrl":"https://bzm.kakao.com/a/bb/ccc"
      }
    }
  }
}

Look up by sender profile key or uuid

This looks up the sender profile that matches the sender profile key (senderKey) or the uuid. You must enter either senderKey or uuid.

GET/api/comm/v1/account/kakao/sender

Looks up the sender profile matching the sender profile key (senderKey) or uuid. You must supply either senderKey or uuid.

Query Parameters

uuid

String

The uuid of the KakaoTalk channel to look up.

senderKey

String

The sender profile key to look up.

Returns

common

Object

The common response section.

data

Object

The service response section.

kakao

Object

The Kakao response section.

senderProfile

Object

The sender profile information.

profileStatus

String

The KakaoTalk channel status.

brandMessage

Boolean

Whether Brand Message targeting is used.

profileSpamLevel

String

The KakaoTalk channel spam status.

profileMessageSpamLevel

String

The KakaoTalk message spam status.

Request example

curl -X GET "https://mars.ibapi.kr/api/comm/v1/account/kakao/sender?uuid={uuid}&senderKey={senderKey}" \
  -H "Authorization: {ApiKey}"

Response example

{
  "common": {
    "authCode":"A000",
    "infobankTrId":"M-260724105147428PRD87100",
    "authResult":"SUCCESS"
  },
  "data": {
    "code":"A000",
    "result":"SUCCESS",
    "resultMsg":"요청 성공",
    "kakao": {
      "senderProfile": {
        "senderKey":"{senderKey}",
        "uuid":"@bizgo",
        "name":"비즈고",
        "status":"A",
        "block": false,
        "dormant": false,
        "profileStatus":"A",
        "createdAt":"2026-07-21 14:43:28",
        "modifiedAt":"2026-07-22 17:04:34",
        "categoryCode":"01800010001",
        "bizchat": true,
        "brandtalk": false,
        "brandMessage": false,
        "committalCompanyName":"",
        "channelKey":"base",
        "businessProfile": true,
        "businessType":"BUSINESS",
        "unsubscribePhoneNumber":"080-1111-2222",
        "unsubscribeAuthNumber":"12345",
        "profileSpamLevel":"정상",
        "profileMessageSpamLevel":"정상",
        "clearBlockUrl":"https://bzm.kakao.com/a/bb/ccc"
      }
    }
  }
}

Manage sender profiles

The sender profile is the reference information for Kakao Biz Message sends. Use these APIs to check the status by sender profile key or to lift a dormant state.

Look up by sender profile key

GET/api/comm/v1/center/kakao/sender

Try it in the Sandbox

Looks up Kakao sender profile information by sender profile key. Use it to check the status of the senderKey used by Alimtalk, Brand Message, and CS Talk.

Query Parameters

senderKey

RequiredString

The sender profile key.

Returns

common

Object

The common response section.

data

Object

The service response section.

data

Object

The actual response data.

kakao

Object

The Kakao Biz Message response data.

senderProfile

Object

The sender profile information.

status

String

The status value.

profileStatus

String

The KakaoTalk channel status.

profileSpamLevel

String

The KakaoTalk channel spam status.

profileMessageSpamLevel

String

The KakaoTalk message spam status.

Request example

curl -X GET "https://mars.ibapi.kr/api/comm/v1/center/kakao/sender?senderKey={senderKey}" \
  -H "Authorization: {ApiKey}"

Response example

{
  "common": {
    "authCode":"A000",
    "authResult":"Success",
    "infobankTrId":"Infobank-Tracking-Id"
  },
  "data": {
    "code":"A000",
    "result":"Success",
    "data": {
      "kakao": {
        "senderProfile": {
          "senderKey":"{senderKey}",
          "uuid":"b1a2c3d4-e5f6-7890-abcd-ef1234567890",
          "name":"비즈고",
          "status":"A",
          "block": false,
          "dormant": false,
          "profileStatus":"A",
          "createdAt":"2026-04-24T11:18:45+09:00",
          "modifiedAt":"2026-04-24T11:18:45+09:00",
          "categoryCode":"001",
          "bizchat": true,
          "brandMessage": true,
          "committalCompanyName":"비즈고",
          "channelKey":"_X1x2x3x4x5x6x7x8x9x0",
          "businessProfile": true,
          "unsubscribePhoneNumber":"0801234567",
          "unsubscribeAuthNumber":"0801234",
          "profileSpamLevel":"정상",
          "profileMessageSpamLevel":"정상",
          "clearBlockUrl":"https://pf.kakao.com/_X1x2x3/unblock"
        }
      }
    }
  }
}

Recover a sender profile from dormancy

POST/api/comm/v1/center/kakao/sender/recover

Try it in the Sandbox

Reactivates a dormant sender profile. Use it when you need to restore the sender profile status before sending Kakao Biz Messages.

Body Parameters

{} JSON

senderKey

RequiredString

The key of the sender profile to reactivate.

Returns

common

Object

The common response section.

data

Object

The service response section.

Request example

curl -X POST "https://mars.ibapi.kr/api/comm/v1/center/kakao/sender/recover" \
  -H "Authorization: {ApiKey}" \
  -H "Content-Type: application/json" \
  -d '{
    "senderKey": "{senderKey}"
  }'

Response example

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

Manage sender profile categories

These APIs look up the sender profile category information used in Kakao Biz Message. Refer to them when you register a sender profile or check operational policy.

Look up all categories

GET/api/comm/v1/center/kakao/sender/category/list

Try it in the Sandbox

Looks up the Kakao Biz Message categories available when registering a sender profile.

Returns

common

Object

The common response section.

data

Object

The service response section.

data

Object

The actual response data.

kakao

Object

The Kakao Biz Message response data.

Look up category details

GET/api/comm/v1/center/kakao/sender/category

Try it in the Sandbox

Looks up Kakao Biz Message category details by category code.

Query Parameters

code

RequiredString

The category code to look up.

Returns

common

Object

The common response section.

data

Object

The service response section.

data

Object

The actual response data.

kakao

Object

The Kakao Biz Message response data.

Manage sender profile groups

A sender profile group is the management unit you use when you operate several sender profiles together. Use these APIs to look up group membership, or to add a sender profile to a group and remove it.

Look up a group by sender profile key

GET/api/comm/v1/center/kakao/group

Try it in the Sandbox

Looks up the linked group information by sender profile key. If you omit senderKey, the response is based on the groups you can access.

Query Parameters

senderKey

String

The sender profile key used for the lookup.

Returns

common

Object

The common response section.

data

Object

The service response section.

data

Object

The actual response data.

kakao

Object

The Kakao Biz Message response data.

groups

Object Array

The list of sender profile groups.

Request example

curl -X GET "https://mars.ibapi.kr/api/comm/v1/center/kakao/group?senderKey={senderKey}" \
  -H "Authorization: {ApiKey}"

Response example

{
  "common": {
    "authCode":"A000",
    "authResult":"Success",
    "infobankTrId":"Infobank-Tracking-Id"
  },
  "data": {
    "code":"A000",
    "result":"Success",
    "data": {
      "kakao": {
        "groups": [
          {
            "groupKey":"{groupKey}",
            "groupName":"기본 그룹"
          }
        ]
      }
    }
  }
}

Add a sender profile to a group

POST/api/comm/v1/center/kakao/group

Try it in the Sandbox

Registers a sender profile in a sender profile group. Pass both the group key and the sender profile key.

Body Parameters

{} JSON

groupKey

RequiredString

The key of the group to register the sender profile in.

senderKey

RequiredString

The sender profile key to register. max: 40

groupName

String

The group name.

Returns

common

Object

The common response section.

data

Object

The service response section.

Request example

curl -X POST "https://mars.ibapi.kr/api/comm/v1/center/kakao/group" \
  -H "Authorization: {ApiKey}" \
  -H "Content-Type: application/json" \
  -d '{
    "groupKey": "{groupKey}",
    "senderKey": "{senderKey}"
  }'

Response example

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

Delete a sender profile from a group

DELETE/api/comm/v1/center/kakao/group/groupKey/{groupKey}/senderKey/{senderKey}

Try it in the Sandbox

Removes a specific sender profile from a sender profile group.

Path Parameters

groupKey

RequiredString

The group key.

senderKey

RequiredString

The sender profile key to delete.

Returns

common

Object

The common response section.

data

Object

The service response section.

Request example

curl -X DELETE "https://mars.ibapi.kr/api/comm/v1/center/kakao/group/groupKey/{groupKey}/senderKey/{senderKey}" \
  -H "Authorization: {ApiKey}"

Response example

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

Manage sanctions

A sanction is a state in which message sending is restricted at the sender profile or template level because of a Kakao Biz Message operational policy violation, suspected spam or abuse, or the state of the KakaoTalk channel. When a sanction applies, sending may be blocked or some send capabilities may be limited, so use the sanction lookup APIs to check operational status before you send.

Look up sender profile sanctions: check the sanction information applied to a specific sender profile.
Look up group template sender profile exclusions: check where a specific sender profile is excluded from or restricted in a group template.
Look up template sanctions: check the sanction information applied to a specific template.

Look up sender profile sanctions

GET/api/comm/v1/center/kakao/abusing/block/sender

Try it in the Sandbox

Looks up the sender profile sanction information for a specific date.

Query Parameters

date

RequiredString

The reference date for the lookup.

senderKey

RequiredString

The sender profile key.

Returns

common

Object

The common response section.

data

Object

The service response section.

data

Object

The actual response data.

kakao

Object

The Kakao Biz Message response data.

abusing

Object

The sanction information.

senderKeyType

String

The sender profile key type.

reasonType

String

The sanction reason.

Request example

curl -X GET "https://mars.ibapi.kr/api/comm/v1/center/kakao/abusing/block/sender?date={date}&senderKey={senderKey}" \
  -H "Authorization: {ApiKey}"

Response example

{
  "common": {
    "authCode":"A000",
    "authResult":"Success",
    "infobankTrId":"Infobank-Tracking-Id"
  },
  "data": {
    "code":"A000",
    "result":"Success",
    "data": {
      "kakao": {
        "abusing": {
          "restrictedAt":"2026-03-05 16:33:17",
          "senderKey":"{senderKey}",
          "templateCode":"{templateCode}",
          "groupKey":"{groupKey}",
          "senderKeyType":"S",
          "reasonType":"BZM"
        }
      }
    }
  }
}

Look up group template sender profile exclusions

GET/api/comm/v1/center/kakao/abusing/block/senderGroup

Try it in the Sandbox

Looks up sanction information where a specific sender profile was excluded from a group template.

Query Parameters

date

RequiredString

The reference date for the lookup.

senderKey

RequiredString

The sender profile key.

groupKey

RequiredString

The group sender profile key.

templateCode

RequiredString

The template code.

Returns

common

Object

The common response section.

data

Object

The service response section.

data

Object

The actual response data.

kakao

Object

The Kakao Biz Message response data.

abusing

Object

The sanction information.

senderKeyType

String

The sender profile key type.

reasonType

String

The sanction reason.

Request example

curl -X GET "https://mars.ibapi.kr/api/comm/v1/center/kakao/abusing/block/senderGroup?date={date}&senderKey={senderKey}&groupKey={groupKey}&templateCode={templateCode}" \
  -H "Authorization: {ApiKey}"

Response example

{
  "common": {
    "authCode":"A000",
    "authResult":"Success",
    "infobankTrId":"Infobank-Tracking-Id"
  },
  "data": {
    "code":"A000",
    "result":"Success",
    "data": {
      "kakao": {
        "abusing": {
          "restrictedAt":"2026-03-05 16:33:17",
          "senderKey":"{senderKey}",
          "templateCode":"{templateCode}",
          "groupKey":"{groupKey}",
          "senderKeyType":"S",
          "reasonType":"BZM"
        }
      }
    }
  }
}

Look up template sanctions

GET/api/comm/v1/center/kakao/abusing/block/template

Try it in the Sandbox

Looks up the sanction information for a specific template.

Query Parameters

date

RequiredString

The reference date for the lookup.

senderKey

RequiredString

The sender profile key.

templateCode

RequiredString

The template code.

Returns

common

Object

The common response section.

data

Object

The service response section.

data

Object

The actual response data.

kakao

Object

The Kakao Biz Message response data.

abusing

Object

The sanction information.

senderKeyType

String

The sender profile key type.

reasonType

String

The sanction reason.

Request example

curl -X GET "https://mars.ibapi.kr/api/comm/v1/center/kakao/abusing/block/template?date={date}&senderKey={senderKey}&templateCode={templateCode}" \
  -H "Authorization: {ApiKey}"

Response example

{
  "common": {
    "authCode":"A000",
    "authResult":"Success",
    "infobankTrId":"Infobank-Tracking-Id"
  },
  "data": {
    "code":"A000",
    "result":"Success",
    "data": {
      "kakao": {
        "abusing": {
          "restrictedAt":"2026-03-05 16:33:17",
          "senderKey":"{senderKey}",
          "templateCode":"{templateCode}",
          "groupKey":"{groupKey}",
          "senderKeyType":"S",
          "reasonType":"CHANNEL"
        }
      }
    }
  }
}