support Contact support
    • Kamino
    • Developers
    • Kamino platform API integration
    • Manage guaranteed campaigns (API v2)

    Create and manage creatives

    Table of Contents

    Overview Main endpoints Attributes

    Overview

    This article explains how to create and manage ad creative items.

    Main endpoints

    Method Endpoint Description Reference
    GET https://api.kaminoretail.dev/v2/line-items/{line_item_id}/creatives Get all creatives for a given line item. Get creatives for a line item
    POST https://api.kaminoretail.dev/v2/line-items/{line_item_id}/creatives Create a creative. Create a creative
    POST https://api.kaminoretail.dev/v2/line-items/{line_item_id}/creatives/batch Create multiple creatives. Create a batch of creatives
    PUT https://api.kaminoretail.dev/v2/line-items/{line_item_id}/creatives/batch Update multiple creatives. Update a batch of creatives
    PUT https://api.kaminoretail.dev/v2/line-items/{line_item_id}/creatives/{creative_id} Update a specific creative. Update a creative

    Attributes

    The following table defines common attributes. The exhaustive list of attributes is available in Create a creative. If you have any questions, contact the Equativ team.

    Attribute Data type Description Example
    additionalStylesElements array[object] For more information, see Upload assets.

    Not applicable 

     

     
    assets array[object] For more information, see Upload assets.

    Not applicable 

     
    formatId integer Kamino internal ID of the format used for the creative. For more information, see Manage grid section. 22
    gridSectionId integer Grid section where the creative will be displayed on the retailer’s website, which is generated internally by Kamino. For more information, see Manage grid section. 123
    language string Optional parameter used to set the language of the creative. fr
    maxBid number Maximum amount you are willing to pay for a single click. This parameter only applies when lineItemCreativesType equals SponsoredProduct (CPC-based line item). 0.8
    products array[string]

    List of product IDs for promoted products in the campaign. 

    The IDs must match the retailer_product_id field from Product catalog attributes.

    		 ["1234", "4536-abc", "EFGH"]

    RELATED ARTICLES