Search...
Menu

API: Updating Creatives (Technical Guide)

Label：API ,API key ,updating creatives ,technical guide ,developer guide

You need to use your Mintegral token to manage your offers. For more details, please check Token.

Here's how you update creatives for offers using Mintegral's API. See the appendix for details on requirements for size, format, and aspect ratios for your creatives.
[Appendix - Creative Dimension].

Request address

https://ss-api.mintegral.com/api/open/v1/offer/apply_creative

This interface is about to be obsolete, please use API—Create Creative Set

Request method

PUT

Request example

json Copy 
PUT /api/open/v1/offer/apply_creative
HTTP/1.1 Host: ss-api.mintegral.com
Content-Type: application/json
{
  "offer_id": 123,
  "ad_type": "REWARDED_VIDEO",
  "creative": [
    {
      "creative_md5":"0a6335cd9151ac5dc79ad996f4e12674",
      "creative_name":"creative_test.png" ,
      "apply_in_area": "CN,EN",
      "option": "ENABLE"
    }
  ]
}

Request Parameter

Fields Type Explanations Default Value Examples
offer_id int Offer ID — 123
ad_type string Target ad types. Separate with commas for multiple ad types. Enum value in ：
[ENUM-ad type(static)]
[ENUM-ad type(video)]		 — "REWARDED_VIDEO"
creative array<json>
creative_md5 string Creative MD5 generated after being uploaded. And is file name by default, please note, creative name must be letters, digits, or the underscore — "0a6335cd9151ac5dc79ad996f4e12674"
creative_name string Creative name generated after being uploaded. — "creative_test"
apply_in_area string Targeted geos for specific creatives. Targeted geos must be in offer's target_geo.
PS: 1. Set "ALL" for targeting all geos in offer. 2. Separate with commas for multiple targeted geos.		 — "CN,EN"
creative_set_name Optional string Creative set name — "default"
option string Status for creative under offers.
Enum value: "ENABLE", "DISABLE".
ENABLE: Allow creative to run in offer. DISABLE: Pause and romove creative from specific offer. Note: Set "ENABLE" for setting up new offers.		 — "DISABLE"

Response

Fields Type Explanations
code int 200 code, is success. Others, are fail.
msg string If success, return to "success". If fail, return to detailed wrong info.
data json If success, return ["success"]. If fail, return to detailed wrong info.

Response Example

json Copy 
{
  "msg": "success",
  "code": 200,
  "data": ["success"]
}
Previous
API: Updating Tracking URL (Technical Guide)
Next
API: Updating Audience Targets (Technical Guide)
Last modified: 2025-08-28