API: Creating Creative Sets (Technical Guide)

Label：API ,API key ,creative set ,developer guide ,technical guide

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

Here's how to create a new creative set using Mintegral's API.

Request method

https://ss-api.mintegral.com/api/open/v1/creative_set

Request method

POST

Request example

json Copy

POST /api/open/v1/creative_set HTTP/1.1
Host: ss-api.mintegral.com
Content-Type: application/json

{
    "creative_set_name": "test_create_group_1",
    "offer_id": 100,
    "geos": [
        "ALL"
    ],
    "ad_outputs": [
        211,
        212,
        213
    ],
    "creatives": [
        {
            "creative_name": "test_creative_1",
            "creative_md5": "abcd"
        },
        {
            "creative_name": "test_creative_2",
            "creative_md5": "cdfg"
        }
    ]
}

Request Params

field	dataType	isRequired	desc	defaultValue
creative_set_name	string	Y	creative set name	-
combination_method	int	N	the combination method of creative_set:1: programmatic creative set 2: customized creative set	`1`
offer_id	int	N	The offer you expect to bind after a creative set is created	—
geos	array<string>	N	Countries/regions where creative sets are used	`["ALL"]`
ad_outputs	array<int>	Y	The types of ideas the creative set expects to assemble are listed below [ENUM Ad Output]	-
creatives	array<object>	Y	List of creatives bound to the creative set	-
creative_name	string	Y	The name of the creative in the creative set	-
creative_md5	string	Y	creative content md5	-

Response

field	dataType	desc
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 to "success". If fail, return to detailed wrong info
creative_set_name	string	creative_set_name
creative_set_id	int	creative_set_id
offer_id	int	offer_id

Response Example

json Copy

{
  "msg": "success",
  "code": 200,
  "data": {
    "creative_set_name": "test_create_group_1",
    "creative_set_id": 2001,
    "offer_id": 100
  }
}

API: Retrieving Creative Set Data (Technical Guide)

API: Deleting Creative Sets (Technical Guide)

Last modified: 2025-08-28

Outline