Create App List

πŸ“˜

POST https://api.kayzen.io/v1/app_list

Use this API to create a new App List

See below for supported body parameters

FieldTypeRequired/ OptionalDescription
namestringrequiredName of the App List
advertiser_idintrequiredAdvertiser ID
app_bundlesstringconditionally requiredComma separated app_bundles.
Atleast one app_bundle/placement_id is required.

Maximum 10,000 app_bundles can be present in an App List.
placement_idsstringconditionally requiredComma separated placement ids.
Atleast one app_bundle/placement_id is required.
Exchange in placement id should exist.

Maximum 10,000 placement_ids can be present in an App List.
descriptionstringoptionalDescription about the App List

Maximum 2000 words are allowed as description
curl --location --request POST 'https://api.kayzen.io/v1/app_lists' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer ACCESS_TOKEN' \
--data '{
  "name": "Hypercasual Apps",
  "advertiser_id": 98219,
  "placement_ids": "10064-595558452,10064-620bb0080b6,10064-5b0bc90385,10064-5f08659e089,10064-5e74cbc777,10064-5e64cbc098,10064-5e24cbc1281,10064-5e74cbccdhs,10064-5ej4cbcbchx,10064-5e94cbc787",
  "app_bundles": "com.king.candycrushsaga,com.funzilla.bullet.stack,com.ht2.stick.hero,com.popreach.dumbways,com.playrix.gardenscapes,com.pronetis.ironball2,com.playrix.township,com.ht2.stick.hero,com.MelsoftGames.FamilyIslandFarm,com.playrix.homescapes",
  "description": "These are the top hypercasual apps"
}'

Response

App List data with has_associated_campaigns - true if the App List has at least one whitelist/blacklist Campaign attached to it.

{
 "id": 9101,
 "name": "Hypercasual Apps",
 "description": "These are the top hypercasual apps",
 "placement_ids": "10064-595558452,10064-620bb0080b6,10064-5b0bc90385,10064-5f08659e089,10064-5e74cbc777,10064-5e64cbc098,10064-5e24cbc1281,10064-5e74cbccdhs,10064-5ej4cbcbchx,10064-5e94cbc787",
 "app_bundles": "com.king.candycrushsaga,com.funzilla.bullet.stack,com.ht2.stick.hero,com.popreach.dumbways,com.playrix.gardenscapes,com.pronetis.ironball2,com.playrix.township,com.ht2.stick.hero,com.MelsoftGames.FamilyIslandFarm,com.playrix.homescapes",
 "has_associated_campaigns": false
}

See below for the response codes

HTTP Status CodeResponse
Success201JSON body containing details about the newly created App List
Error422JSON body containing the error details