kakao developers

Business Form linkage management

This document describes how to use the Business Form linkage management APIs.

View list of linked Business Forms

This API enables you to retrieve the list of Business Forms with permission granted to the designated ad account. You can check the detailed information of the Business Form created with your Kakao Account in [비즈니스 도구(Business tools)] > [비즈니스폼(Business Form)] in Business Admin Center.

Send a GET request with the issued access token and an ad account ID (adAccountId) in the request header. If the request is successful, this API returns the list of the Business Forms in JSON format. If failed, refer to Error code to figure out its failure cause.

Request

URL

GET /openapi/v4/talkBizForms/linkages HTTP/1.1
Host: apis.moment.kakao.com
Authorization: Bearer ${ACCESS_TOKEN}

Header

Name	Type	Description	Required
Authorization	String	Pass an access token in Bearer ${ACCESS_TOKEN} format.	O
adAccountId	Long	Ad account's ID.	O

Response

Name	Type	Description
-	LinkedBusinessForm[]	List of Business Forms.

LinkedBusinessForm

Name	Type	Description
adAccountId	Long	Ad account's ID.
id	Long	Business Form's linkage ID.
bizFormId	Long	Business Form's ID.
title	String	Business Form's name.
flowType	String	Type. Either APPLY (Immediately apply type) or SURVEY (Survey type).
dspAccountEmail	String	Account email linked to the Business Form.
beginDate	String	Start time of delivery period in yyyy-MM-dd'T'HH:mm:ss format.
endDate	String	End time of delivery period in yyyy-MM-dd'T'HH:mm:ss format.
linkedDate	String	Linkage time in yyyy-MM-dd'T'HH:mm:ss format.

Sample

Request

curl -X GET "https://apis.moment.kakao.com/openapi/v4/talkBizForms/linkages" \
    -H "Authorization: Bearer ${ACCESS_TOKEN}" \
    -H "adAccountId: {adAccountId}"

Response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
[
    {
        "id": 1,
        "adAccountId": 1234,
        "bizFormId": 1111,
        "dspAccountEmail": "email@kakao.com",
        "title": "first_talk_business_form",
        "flowType": "SURVEY",
        "linkedDate": "2020-01-01 00:00:00",
        "beginDate": "2020-02-01 00:00",
        "endDate": "2020-03-01 00:00"
    }
]

View list of linkable Business Forms

This API enables you to retrieve the list of Business Forms that permission can be added to.

Send a GET request with the issued access token and an ad account ID (adAccountId) in the request header. If the request is successful, this API returns the list of the Business Forms in JSON format. If failed, refer to Error code to figure out its failure cause.

Request

URL

GET /openapi/v4/talkBizForms/linkables HTTP/1.1
Host: apis.moment.kakao.com
Authorization: Bearer ${ACCESS_TOKEN}

Header

Name	Type	Description	Required
Authorization	String	Pass an access token in Bearer ${ACCESS_TOKEN} format.	O
adAccountId	Long	Ad account's ID.	O

Response

Name	Type	Description
-	LinkablesBusinessForm[]	List of Business Forms.

LinkablesBusinessForm

Name	Type	Description
bizFormId	Long	Business Form's ID. Pass bizFormId when requesting the Linking Business Form API.
title	String	Business Form's name.
flowType	String	Type. Either APPLY (Immediately apply type) or SURVEY (Survey type).
beginDate	String	Start time of delivery period in yyyy-MM-dd'T'HH:mm:ss format.
endDate	String	End time of delivery period in yyyy-MM-dd'T'HH:mm:ss format.

Sample

Request

curl -X GET "https://apis.moment.kakao.com/openapi/v4/talkBizForms/linkables" \
    -H "Authorization: Bearer ${ACCESS_TOKEN}" \
    -H "adAccountId: {adAccountId}"

Response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
[
    {
        "bizFormId": 5678,
        "adAccountId": 1234,
        "title": "first_talk_business_form",
        "flowType": "APPLY",
        "beginDate": "2020-02-01 00:00",
        "endDate": "2020-03-01 00:00"
    }
]

Link Business Form

This API enables you to link a specific Business Form to an ad account.

Send a GET request with the issued access token and an ad account ID (adAccountId) in the request header. If the request is successful, this API returns the information of the added Business Form. If failed, refer to Error code to figure out its failure cause.

Request

URL

POST /openapi/v4/talkBizForms HTTP/1.1
Host: apis.moment.kakao.com
Authorization: Bearer ${ACCESS_TOKEN}

Header

Name	Type	Description	Required
Authorization	String	Pass an access token in Bearer ${ACCESS_TOKEN} format.	O
adAccountId	Long	Ad account's ID.	O

Parameter

Name	Type	Description	Required
bizFormId	Long	Business Form's ID.	O

Response

Name	Type	Description
id	Long	Business Form's linkage ID.
adAccount	Long	Ad account's ID.
bizFormId	Long	Business Form's ID.
dspAccountEmail	String	Account email linked to the Business Form.
title	String	Business Form's title.
flowType	String	Type. Either APPLY (Immediately apply type) or SURVEY (Survey type).
beginDate	String	Start time of delivery period in yyyy-MM-dd'T'HH:mm:ss format.
endDate	String	End time of delivery period in yyyy-MM-dd'T'HH:mm:ss format.
linkedDate	String	Linkage time in yyyy-MM-dd'T'HH:mm:ss format.

Sample

Request

curl -X POST "https://apis.moment.kakao.com/openapi/v4/talkBizForms" \
    -H "Authorization: Bearer ${ACCESS_TOKEN}"
    -H "adAccountId: {adAccountId}"
    -d '{
            "id": 1234
        }'

Response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
{
    "id": 1,
    "adAccountId": 1234,
    "bizFormId": 1,
    "dspAccountEmail": "email@kakao.com",
    "title": "first_talk_business_form",
    "flowType": "APPLY",
    "linkedDate": "2020-01-01 15:00:00",
    "beginDate": "2020-02-01 00:00",
    "endDate": "2020-03-01 00:00"
}

See more

• Kakao Moment API Reference