Skip to content
Component Creatives
/
Update a Single component creative

Component Creatives API (1.0)

The terms creative components and native components may be used interchangeably. The front part of the endpoint is:

QA API Base: https://t1qa1.mediamath.com/component_creatives/v1.0/ (or whichever QA server is being used)

Prod API Base: https://t1.mediamath.com/component_creatives/v1.0

Component Creatives are uploaded in the "Creatives Tab" within the Creatives Module, and is where creatives for native campaigns are uploaded.

Download OpenAPI description
component-creatives.json
component-creatives.yaml
Overview
URL

https://www.mediamath.com/contact-us/

API Support

developers@mediamath.com

License

Apache 2.0

Languages
Servers

https://t1.mediamath.com/

Component Creatives

Operations

Get a Single Component Creative

Request

Get a single component creative

Path
component_idintegerrequired

See below

curl -i -X GET \
  'https://t1.mediamath.com/component_creatives/v1.0/components/{component_id}'

Responses

Bodyapplication/json
Response
application/json
{
  "data": {
    "char_limit": null,
    "component_human_name": "Destination URL",
    "component_id": 4,
    "created_at": "2016-12-01T03:56:44.085Z",
    "is_enabled": true,
    "updated_at": "2016-12-01T03:56:44.085Z",
    "value_type_name": "TEXT"
  },
  "meta": {
    "code": 200,
    "status": "success",
    "type": "component"
  }
}

Update a Single component creative

Request

Update a Single component creative

Path
component_idintegerrequired

See below

Bodyapplication/json

See below

any
curl -i -X POST \
  'https://t1.mediamath.com/component_creatives/v1.0/components/{component_id}' \
  -H 'Content-Type: application/json'

Responses

Bodyapplication/json
Response
application/json
{
  "data": {
    "char_limit": null,
    "component_human_name": "Destination URL",
    "component_id": 4,
    "created_at": "2016-12-01T03:56:44.085Z",
    "is_enabled": true,
    "updated_at": "2016-12-01T03:56:44.085Z",
    "value_type_name": "TEXT"
  },
  "meta": {
    "code": 200,
    "status": "success",
    "type": "component"
  }
}

Create a New Asset Collection

Request

Create an asset and optionally associate it with a creative. Either an advertiser_id or creative_ids must be provided. All creatives in creative_ids must belong to the same advertiser.

The ID of the created asset will be in the response.

Request text asset (application/json)

Attributes (NewTextAsset)

Headers

Cookie: adama_session={adama_session}

The body shown below is for a text asset.

An image asset body might be in the form of: ------WebKitFormBoundary7MA4YWxkTrZu0gW Content-Disposition: form-data; name="component_id"

2 ------WebKitFormBoundary7MA4YWxkTrZu0gW Content-Disposition: form-data; name="asset_value"; filename="" Content-Type:

------WebKitFormBoundary7MA4YWxkTrZu0gW Content-Disposition: form-data; name="creative_ids"

[3200795] ------WebKitFormBoundary7MA4YWxkTrZu0gW Content-Disposition: form-data; name="advertiser_id"

100178 ------WebKitFormBoundary7MA4YWxkTrZu0gW--

Headers
adama_sessionstring

adama_session

Bodyapplication/json

See below

any
curl -i -X POST \
  https://t1.mediamath.com/component_creatives/v1.0/assets \
  -H 'Content-Type: application/json' \
  -H 'adama_session: string'

Responses

Body
Response
{
  "data": {
    "advertiser_id": 100178,
    "asset_id": 1546,
    "asset_name": null,
    "component_human_name": "Image",
    "component_id": 2,
    "created_at": "2016-11-18T16:38:45.375Z",
    "image_file_size": 5052,
    "image_filename": "logo.png",
    "image_height": 100,
    "image_url": "https://s3.amazonaws.com/mm-component-creative/1479487125286_227082bd4ced0f888aa0066f06ea1402_logo.png",
    "image_width": 160,
    "updated_at": "2016-11-18T16:38:45.375Z"
  },
  "meta": {
    "code": 201,
    "status": "created",
    "type": "asset"
  }
}