This document describes how to use the Creative APIs.

With the update on August 26, 2025, the following promotional image aspect ratios have been added.

With the update on December 17, 2024, the following Video type of creatives has been added.

With the update on September 5, 2024, the following Display type of creatives has been added.

With the update on August 30, 2023, the following Display type of creatives has been added.

With the update on February 21, 2023, the types of creatives that can be created for each campaign type have been changed as follows.

You can now use various creative landing types and landing settings, along with the URL that has been provided already. You can set a creative landing type only under the 'Kakao Bizboard' type of campaign.

We now provide the APIs that retrieve a list to set a landing type, but do not provide the APIs to create an Ad View, Business Form, or others. In the case of purchases using Kakao Pay, you are only allowed to retrieve, not create or modify.

You can check how to use each creative landing type in the table below.

Creates a Display creative.

When you request, you must set format (Creative format) to either IMAGE_BANNER, IMAGE_NATIVE, CATALOG_MANUAL, or VIDEO_NATIVE. Depending on the specified creative format, you need to pass different parameters when you request. For example, pass imageFileUrl for the image banner format, pass both imageFileUrl and profileImageFileUrl for the image native format, pass both slides list and profileImageFileUrl for the image catalog format, and pass videoFileUrl and profileImageFileUrl for video native format.

This API supports two types of Content-Type to create an image — application/json and multipart/form-data.

• application/json: Pass the creative's image path with http:// or https:// URI scheme through the imageFileUrl parameter.
• multipart/form-data: Pass the creative's local file path through the imageFile parameter.

Send a POST request with the issued business token and an ad account ID (adAccountId) in the request header. If the request is successful, this API returns the detailed information of the created creative. If failed, refer to Error code to figure out its failure cause.

This API limits the number of calls you can make every second per user account and ad account.

• The previous name of Slides, AssetGroup, will no longer be available after 2025.9.30.

curl -X POST "https://apis.moment.kakao.com/openapi/v4/creatives" \
  -H "Authorization: Bearer ${BUSINESS_ACCESS_TOKEN}" \
  -H "adAccountId: ${AD_ACCOUNT_ID}"
-H "Content-Type: application/json" \
  -d '{
            "adGroupId":1234,
            "format":"IMAGE_BANNER",
            "imageFileUrl":"https://www.image.com/sample.png",
            "altText":"creative_description",
            "landingInfo": {
                "landingType":"AD_VIEW",
                "adViewItem":{"id":1}
            },
            "name": "first_image_banner"
        }'

curl -X POST "https://apis.moment.kakao.com/openapi/v4/creatives" \
  -H "Authorization: Bearer ${BUSINESS_ACCESS_TOKEN}" \
  -H "adAccountId: ${AD_ACCOUNT_ID}" \
  -H "Content-Type: multipart/form-data" \
  -F "adGroupId=1234" \
  -F "format=IMAGE_BANNER" \
  -F "imageFile=@local_640X200_image_path" \
  -F "altText=creative_description" \
  -F "name=first_image_banner" \
  -F "mobileLandingUrl=http://www.daum.net" \
  -F "landingInfo.landingType=AD_VIEW" \
  -F "landingInfo.adViewItem.id=search_query"

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
{
    "id": 1,
    "creativeId": 2,
    "adGroupId": 1234,
    "format": "IMAGE_BANNER",
    "name": "first_image_banner",
    "landingInfo": {
        "landingType": "AD_VIEW",
        "adViewItem": {"id":1}
    },
    "pcLandingUrl": null,
    "mobileLandingUrl": "&bid=null&DA=XYZ",
    "rspvLandingUrl": null,
    "frequencyCap": null,
    "frequencyCapType": "AUTO",
    "config": "ON",
    "systemConfig": "ON",
    "reviewStatus": "WAITING",
    "image": {
        "url": "http://xxx.kakao.co.kr/sample_image_banner_xxx.jpeg",
        "fileName": "sample.jpeg",
        "width": 640,
        "height": 100,
        "size": 50000
    },
    "altText": "creative_description",
    "statusDescription": "심사중",
    "createdDate": "2020-01-01T00:00:00.00000",
    "lastModifiedDate": "2020-01-01T00:00:00.000000",
    "rejectedReason": []
}

Enables you to edit display creatives.

The parameters to be provided differ depending on the creative type. For example, IMAGE_BANNER requires imageFileUrl, IMAGE_NATIVE requires both imageFileUrl and profileImageFileUrl, CATALOG_MANUAL requires slides list and profileImageFileUrl, and VIDEO_NATIVE requires both videoFileUrl and profileImageFileUrl.

This API enables you to edit a Display creative. Depending on the creative type, you need to pass different parameters when you request. For example, pass imageFileUrl for image banner format, and pass both imageFileUrl and profileImageFileUrl for image native format, and pass videoFileUrl and profileImageFileUrl for video native format.

This API supports two types of Content-Type to create an image — application/json and multipart/form-data.

• application/json: Pass the creative's image path in http:// or https:// URI scheme through the imageFileUrl parameter.
• multipart/form-data: Pass the creative's local file path through the imageFile parameter.

No matter which type you request, the result of editing a creative is the same. If there is no imageFileUrl or profileImageFileUrl in the request body, the image that has previously registered is used.

Send a PUT request with the issued business token and an ad account ID (adAccountId) in the request header. If the request is successful, this API returns the detailed information of the modified creative. Some response fields may return null even though they are not used. If failed, refer to Error code to figure out its failure cause.

This API limits the number of calls you can make every second per user account and ad account.

curl -X PUT "https://apis.moment.kakao.com/openapi/v4/creatives" \
  -H "Authorization: Bearer ${BUSINESS_ACCESS_TOKEN}" \
  -H "adAccountId: ${AD_ACCOUNT_ID}" \
  -H "Content-Type: application/json" \
  -d '{
            "id":1234,
            "adGroupId":5678,
            "format":"IMAGE_BANNER",
            "imageFileUrl":"http://www.company.com/images/sample_image_banner.jpg",
            "altText":"edit_creative_description",
            "mobileLandingUrl":"http://www.daum.net",
            "name":"edit_image"
        }'

curl -X PUT "https://apis.moment.kakao.com/openapi/v4/creatives" \
  -H "Authorization: Bearer ${BUSINESS_ACCESS_TOKEN}" \
  -H "adAccountId: ${AD_ACCOUNT_ID}" \
  -H "Content-Type: multipart/form-data" \
  -F "id=1234" \
  -F "adGroupId=5678" \
  -F "format=IMAGE_BANNER" \
  -F "imageFile=@local_640X200_image_path" \
  -F "altText=edit_creative_description" \
  -F "mobileLandingUrl=http://www.daum.net"

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
{
    "id": 1234,
    "creativeId": 1235,
    "adGroupId": 5678,
    "format": "IMAGE_BANNER",
    "name": "edit_image",
    "landingInfo": {
        "landingType": "AD_VIEW",
        "communicatorAdViewId": 1
    },
    "pcLandingUrl": null,
    "mobileLandingUrl": null,
    "rspvLandingUrl": null,
    "frequencyCap": null,
    "frequencyCapType": "AUTO",
    "config": "ON",
    "systemConfig": "ON",
    "reviewStatus": "WAITING",
    "image": {
        "url": "http://xxx.kakao.co.kr/sample_image_banner_xxx.jpg",
        "fileName": "sample_image_banner.jpg",
        "width": 640,
        "height": 100,
        "size": 50000
    },
    "altText": "edit_creative_description",
    "statusDescription": "심사중",
    "createdDate": "2020-01-01T00:00:00.00000",
    "lastModifiedDate": "2020-01-01T00:00:00.000000",
    "rejectedReason": []
}

Enables you to copy a Display creative.

You can request to copy up to 20 creatives but may fail to copy if exceeding the maximum number of creatable creatives of an account.

You can copy only the Image banner, Image native, Image catalog, and Video native creatives under the 'Kakao Bizboard X Visit(방문)', 'Kakao Bizboard X Conversion(전환)', 'Display X Visit(방문)', 'Display X Conversion(전환)', and 'Vidoe X View(조회)' type of campaign.

Send a POST request with the issued business token and an ad account ID (adAccountId) in the request header. You must also pass the ad group ID which the creatives will copy to and the creative IDs to be copied as a list. If the request is successful, this API returns the detailed information of the copied creatives. If failed, refer to Error code to figure out its failure cause.

This API limits the number of calls you can make to every five seconds per user account and ad account.

curl -X POST "https://apis.moment.kakao.com/openapi/v4/creatives/copy" \
  -H "Authorization: Bearer ${BUSINESS_ACCESS_TOKEN}" \
  -H "adAccountId: ${AD_ACCOUNT_ID}" \
  -d '{
            "adGroupId" : 23456,
            "creativeIds" : [34567,34568]
        }'

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
[
    {
        "id": 35678,
        "creativeId": 35678,
        "adGroupId": 23456,
        "format": "IMAGE_BANNER",
        "name": "image_creative1",
        "landingInfo": {
            "landingType": "URL",
            "url": "http://m.daum.net"
        },
        "pcLandingUrl": null,
        "mobileLandingUrl": "http://m.daum.net",
        "rspvLandingUrl": null,
        "frequencyCap": null,
        "frequencyCapType": "AUTO",
        "config": "ON",
        "systemConfig": "ON",
        "reviewStatus": "APPROVED",
        "creativeStatus": "OPERATING",
         "image": {
            "url": "http://xxx.kakao.co.kr/sample_image_111.jpg",
            "fileName": "sample_image.jpg",
            "width": 640,
            "height": 480,
            "size": 100000
        },
        "altText": "image_description1",
        "title": "Title",
        "description": "Promotion text",
        "actionButton": "JOIN",
        "profileName": "Profile name",
        "profileImage": {
            "url": "http://xxx.kakao.co.kr/sample_profile_111.jpg",
            "fileName": "sample_profile.jpg",
            "width": 300,
            "height": 300,
            "size": 50000
        },
        "video": {
            "url": "http://xxx.kakao.co.kr/sample_image_111.avi",
            "fileName": "sample_video.avi",
            "size": 500000,
            "duration": 3.0
        },
        "statusDescription": "운영중",
        "rejectedReason": [],
        "createdDate": "2020-01-01T00:00:00.000000",
        "lastModifiedDate": "2020-01-01T00:00:00.000000",
        "opinionProof": null,
        "thumbnailImage": {
            "url": "http://xxx.kakao.co.kr/sample_image_111.jpg",
            "fileName": "sample_image.jpg",
            "width": 640,
            "height": 480,
            "size": 100000
    },
    {
        "id": 35679,
        "creativeId": 35679,
        "adGroupId": 23456,
        "format": "IMAGE_BANNER",
        "name": "image_creative2",
        "landingInfo": {
            "landingType": "URL",
            "url": "http://m.daum.net"
        },
        "pcLandingUrl": null,
        "mobileLandingUrl": "http://m.daum.net",
        "rspvLandingUrl": null,
        "frequencyCap": null,
        "frequencyCapType": "AUTO",
        "config": "ON",
        "systemConfig": "ON",
        "reviewStatus": "APPROVED",
        "creativeStatus": "OPERATING",
        "image": {
            "url": "http://xxx.kakao.co.kr/sample_image_222.jpg",
            "fileName": "sample_image.jpg",
            "width": 640,
            "height": 480,
            "size": 100000
        },
        "altText": "image_description2",
        "title": "Title",
        "description": "Promotion text",
        "actionButton": "JOIN",
        "profileName": "Profile name",
        "profileImage": {
            "url": "http://xxx.kakao.co.kr/sample_profile_222.jpg",
            "fileName": "sample_profile.jpg",
            "width": 300,
            "height": 300,
            "size": 50000
        },
        "video": {
            "url": "http://xxx.kakao.co.kr/sample_image_222.avi",
            "fileName": "sample_video.avi",
            "size": 500000,
            "duration": 3.0
        },
        "statusDescription": "운영중",
        "rejectedReason": [],
        "createdDate": "2020-01-01T00:00:00.000000",
        "lastModifiedDate": "2020-01-01T00:00:00.000000",
        "opinionProof": null,
        "thumbnailImage": {
            "url": "http://xxx.kakao.co.kr/sample_image_222.jpg",
            "fileName": "sample_image.jpg",
            "width": 640,
            "height": 480,
            "size": 100000
    }
]

Retrieves the materials for verification that are submitted for the corresponding Display creative.

Send a GET request with the issued business token in the request header. If the request is successful, this API returns the information on the materials for verification in JSON format. If failed, refer to Error code to figure out its failure cause.

curl -X GET "https://apis.moment.kakao.com/openapi/v4/creatives/${ID}/opinionProof" \
  -H "Authorization: Bearer ${BUSINESS_ACCESS_TOKEN}" \
  -H "adAccountId: ${AD_ACCOUNT_ID}"

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
{
    "id": 1,
    "opinion": "의견증빙",
    "opinionProofFileList": [
        {
            "id": 11,
            "originalFileName": "sample_1.jpg",
            "downloadUrl": "https://xxx.kakao.com/sample_1.jpg"
        }
    ]
}

{
  "code": -813,
  "msg": "KakaoMomentException",
  "extras": {
    "detailCode": 75637,
    "detailMsg": "의견증빙 정보가 존재하지 않습니다."
  }
}

• Kakao Moment API Reference