Skip to main content
POST
  • All recipients in a request receive the same message content.
  • If the message type requires an image, call Upload a Brand Message image first. Use the returned data.images[].url value.
  • For PREMIUM_VIDEO, set videoUrl to the delivery URL that Kakao BizMessage’s video upload API returns after registration and encoding. A general video URL or a KakaoTV page URL does not work. Notifly currently has no public video upload API. If you need video upload, contact contact@notifly.tech.
  • Free-form messages support M, N, and I audiences. They do not support I+N.
  • The endpoint supports channels that use the Notifly KakaoTalk delivery platform. Channels using Notifly (Legacy) cannot use this endpoint.

Authorizations

Authorization
string
header
required

Pass the token issued by POST /authenticate as a bearer token.

Body

application/json
projectId
string
required

Project ID shown on the Notifly settings page.

channelId
string
required

Kakao Channel ID registered as a Kakao Business Message sender in the project.

target
enum<string>
required

Target audience. M means members who have consented to marketing messages. N means members who have consented to marketing messages and are not channel friends. I means channel friends. Free-form messages do not support I+N.

Available options:
M,
N,
I
recipientList
object[]
required

Recipients. All recipients in the same request receive the same message content.

Required array length: 1 - 1000 elements
chatBubbleType
enum<string>
required

Message type

Available options:
TEXT
message
string
required

Message delivered to the user.

  • Up to 99 line breaks.
  • URLs are allowed.
Maximum string length: 1300
adult
boolean
default:false

Whether the message is for adults only.

attachment
object

Content attached to the message

Response

The send request was queued. This response only confirms queue acceptance.

success
enum<boolean>
required

true means the send request has been accepted into the queue. It does not confirm successful sending by Kakao.

Available options:
true