Skip to content
/
Create atomic creative

Create atomic creative

Request

Create an atomic creative

Security
Auth0(Required scopes: offline_accessmanage:services)
Query
extendedboolean

Get extended properties in response

Bodyapplication/json
widthinteger, (int32)required
Example:80
namestring, [ 1 .. 256 ] charactersrequired
heightinteger, (int32)required
Example:90
creative_import_file_idinteger, (int32)
Example:5
file_typestring
Default:"unknown"
Enum:"swf""gif""html5""jpg""jpeg""tiff""tif""png""unknown""vast"
is_multi_creativeboolean
Default:false
has_soundboolean
Default:false
rich_mediaboolean
Default:false
rich_media_providerstring
builtboolean
Default:false
build_datestring
build_errorsstring
external_identifierstring, [ 1 .. 64 ] characters
expandstring
expansion_triggerstring
Default:"MOUSEOVER"
Enum:"AUTOMATIC""MOUSEOVER""CLICK"
tpas_ad_tagstring
edited_tagstring
click_through_urlstring or null, (uri), <= 2048 characters
concept_idinteger or null, (int32)
Example:7
statusboolean
Default:true
archivedboolean
Default:false
is_mraidboolean
Default:false
is_httpsboolean
Default:false
t1asboolean
Default:false
start_datestring or null
end_datestring or null
vast_versionnumber or null, (float), [ 0 .. 9.9 ]
is_audioboolean or null
expansion_directionstring, <= 19 characters
Default:"NONRESTRICTED"
media_typestring
Default:"display"
Enum:"display""video""mobile"
ad_server_typestring
Enum:"ADOCADO""ATLAS""DART""DOUBLECLICK""EYEWONDER""FLASHTALKING""MEDIAFORGE""MEDIAMIND""MEDIAPLEX""OTHER"
ad_formatstring
Default:"DISPLAY"
Enum:"DISPLAY""MOBILE""EXPANDABLE""FBX""COMPONENT"
tpas_ad_tag_namestring, [ 1 .. 255 ] characters
click_urlstring or null, (uri), <= 10000 characters
sizmek_tag_statusstring
Default:"NOT_USED"
sizmek_creative_statusstring
Default:"NOT_USED"
advertiser_idinteger, (int32), >= 1required
tagstring
tag_typestring
Enum:"IFRAME_SCRIPT_NOSCRIPT""IFRAME_SCRIPT""IFRAME_NOSCRIPT""IFRAME_IMG""SCRIPT_NOSCRIPT""SCRIPT""NOSCRIPT""IFRAME""IMG""VIDEO"
vendor_idsArray of integers, (int32)
Example:
[
  3,
  56
]
POST
/atomic_creatives
curl -i -X POST \
  'https://api.mediamath.com/api/v3.0/atomic_creatives?extended=true' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "width": 80,
    "name": "string",
    "height": 90,
    "creative_import_file_id": 5,
    "file_type": "swf",
    "is_multi_creative": false,
    "has_sound": false,
    "rich_media": false,
    "rich_media_provider": "string",
    "built": false,
    "build_date": "string",
    "build_errors": "string",
    "external_identifier": "string",
    "expand": "string",
    "expansion_trigger": "AUTOMATIC",
    "tpas_ad_tag": "string",
    "edited_tag": "string",
    "click_through_url": "http://example.com",
    "concept_id": 7,
    "status": true,
    "archived": false,
    "is_mraid": false,
    "is_https": false,
    "t1as": false,
    "start_date": "string",
    "end_date": "string",
    "vast_version": 9.9,
    "is_audio": true,
    "expansion_direction": "NONRESTRICTED",
    "media_type": "display",
    "ad_server_type": "ADOCADO",
    "ad_format": "DISPLAY",
    "tpas_ad_tag_name": "string",
    "click_url": "http://example.com",
    "sizmek_tag_status": "NOT_USED",
    "sizmek_creative_status": "NOT_USED",
    "advertiser_id": 1,
    "tag": "string",
    "tag_type": "IFRAME_SCRIPT_NOSCRIPT",
    "vendor_ids": [
      3,
      56
    ]
  }'

Responses

Atomic creative response

Bodyapplication/json
dataatomic_creative_response (object) or atomic_creative_response_extended (object)
Any of:
metaobject(single_metadata)
Response
{
  "data": {
    "id": 0,
    "version": 0,
    "entity_type": "string",
    "advertiser_id": 0,
    "concept_id": 0,
    "concept_name": "string",
    "name": "string",
    "width": 0,
    "height": 0,
    "creative_import_file_id": 0,
    "file_type": "string",
    "is_https": true,
    "is_multi_creative": true,
    "has_sound": true,
    "rich_media": true,
    "rich_media_provider": "string",
    "status": true,
    "archived": true,
    "built": true,
    "build_date": "string",
    "built_by_user_id": 0,
    "build_errors": "string",
    "created_on": "2019-08-24T14:15:22Z",
    "last_modified": "string",
    "external_identifier": "string",
    "tpas_ad_tag_name": "string",
    "updated_on": "2019-08-24T14:15:22Z",
    "expand": "string",
    "click_url": "string",
    "ad_format": "string",
    "expansion_direction": "NONRESTRICTED",
    "expansion_trigger": "AUTOMATIC",
    "ad_server_type": "string",
    "t1as": true,
    "tpas_ad_tag": "string",
    "edited_tag": "string",
    "click_through_url": "string",
    "rejected_reason": "string",
    "approval_status": "string",
    "start_date": "string",
    "end_date": "string",
    "media_type": "string",
    "is_mraid": true,
    "vast_version": 9.9,
    "sizmek_tag_status": "string",
    "sizmek_creative_status": "string",
    "last_payload_modified": "string",
    "is_audio": true,
    "tag": "string",
    "tag_type": "string"
  },
  "meta": {
    "status": "success"
  }
}