Skip to content

Component Creatives

/

Create a Component

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

Servers

https://t1.mediamath.com/

Component Creatives

Operations

List Components

Request

List components

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

Responses

Bodyapplication/json

Response

application/json

{
  "data": [
    { … },
    { … },
    { … },
    { … },
    { … },
    { … },
    { … },
    { … },
    { … }
  ],
  "meta": {
    "code": 200,
    "status": "success",
    "total_count": 9,
    "type": "component"
  }
}

Create a Component

Request

Access is restricted to certain T1 user IDs stored in the database, disallowed users will receive a 401 eeror message.

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

Headers

adama_sessionstring

See below

Bodyapplication/json

{ "component_human_name": "Right Image", "component_name": "right_image", "value_type_name": "IMAGE" }

any

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

Responses

Bodyapplication/json

Response

application/json

{
  "data": {
    "char_limit": null,
    "component_human_name": "Right Image",
    "component_id": 11,
    "created_at": "2016-11-17T19:58:06.894Z",
    "is_enabled": true,
    "updated_at": "2016-11-17T19:58:06.894Z",
    "value_type_name": "IMAGE"
  },
  "meta": {
    "code": 201,
    "status": "created",
    "type": "component"
  }
}

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"
  }
}