--- title: "Bulk Update Atomic Creatives" method: POST path: "/bulk_update/atomic_creatives" tags: ["Atomic Creatives"] --- # Bulk Update Atomic Creatives `POST /bulk_update/atomic_creatives` ## Request - Base URL: `https://api.mediamath.com/api/v3.0` - URL: `https://api.mediamath.com/api/v3.0/bulk_update/atomic_creatives` - Auth: OAuth 2 - Authorization code: `https://auth.mediamath.com/authorize` - Token URL: `https://auth.mediamath.com/oauth/token` scopes: `offline_access`, `manage:services` - TypeScript: (a function with typed inputs; its response is checked against the schema) Update multiple atomic creatives ## Query parameters - `extended` boolean ## Request body - object - `atomic_creatives` object - `create` object[] - `width` integer, required - `name` string, required - `height` integer, required - `creative_import_file_id` integer - `file_type` 'swf' | 'gif' | 'html5' | 'jpg' | 'jpeg' | 'tiff' | 'tif' | 'png' | 'unknown' | 'vast' - `is_multi_creative` boolean - `has_sound` boolean - `rich_media` boolean - `rich_media_provider` string - `built` boolean - `build_date` string - `built_by_user_id` integer - `build_errors` string - `external_identifier` string - `expand` string - `expansion_trigger` 'AUTOMATIC' | 'MOUSEOVER' | 'CLICK' - `tpas_ad_tag` string - `edited_tag` string - `click_through_url` string, uri, nullable - `concept_id` integer, nullable - `status` boolean - `archived` boolean - `is_mraid` boolean - `is_https` boolean - `t1as` boolean - `start_date` string, nullable - `end_date` string, nullable - `vast_version` number, float, nullable - `is_audio` boolean, nullable - `expansion_direction` string - `media_type` 'display' | 'video' | 'mobile' - `ad_server_type` 'ADOCADO' | 'ATLAS' | 'DART' | 'DOUBLECLICK' | 'EYEWONDER' | 'FLASHTALKING' | 'MEDIAFORGE' | 'MEDIAMIND' | 'MEDIAPLEX' | 'OTHER' | 'POINTROLL' | 'SIZMEK' | 'TERMINALONE' | 'TRUEFFECT' | 'YIELD_MANAGER' - `ad_format` 'DISPLAY' | 'MOBILE' | 'EXPANDABLE' | 'FBX' | 'COMPONENT' - `tpas_ad_tag_name` string - `click_url` string, uri, nullable - `sizmek_tag_status` string - `sizmek_creative_status` string - `advertiser_id` integer, required - `tag` string - `tag_type` 'IFRAME_SCRIPT_NOSCRIPT' | 'IFRAME_SCRIPT' | 'IFRAME_NOSCRIPT' | 'IFRAME_IMG' | 'SCRIPT_NOSCRIPT' | 'SCRIPT' | 'NOSCRIPT' | 'IFRAME' | 'IMG' | 'VIDEO' - `vendor_ids` integer[] - `update` object[] - `id` integer - `name` string - `version` integer - `external_identifier` string, nullable - `width` integer - `height` integer - `concept_id` integer, nullable - `status` boolean - `archived` boolean - `is_mraid` boolean - `is_https` boolean - `t1as` boolean - `start_date` string, date-time, nullable - `end_date` string, date-time, nullable - `vast_version` number, float, nullable - `is_audio` boolean, nullable - `expansion_direction` string - `expansion_trigger` 'AUTOMATIC' | 'MOUSEOVER' | 'CLICK' - `media_type` 'display' | 'video' | 'mobile' - `ad_server_type` 'ADOCADO' | 'ATLAS' | 'DART' | 'DOUBLECLICK' | 'EYEWONDER' | 'FLASHTALKING' | 'MEDIAFORGE' | 'MEDIAMIND' | 'MEDIAPLEX' | 'OTHER' | 'POINTROLL' | 'SIZMEK' | 'TERMINALONE' | 'TRUEFFECT' | 'YIELD_MANAGER' - `ad_format` 'DISPLAY' | 'MOBILE' | 'EXPANDABLE' | 'FBX' | 'COMPONENT' - `tpas_ad_tag` string - `tpas_ad_tag_name` string - `click_through_url` string, uri, nullable - `click_url` string, uri, nullable - `edited_tag` string - `tag` string, nullable - `built_by_user_id` integer - `tag_type` 'IFRAME_SCRIPT_NOSCRIPT' | 'IFRAME_SCRIPT' | 'IFRAME_NOSCRIPT' | 'IFRAME_IMG' | 'SCRIPT_NOSCRIPT' | 'SCRIPT' | 'NOSCRIPT' | 'IFRAME' | 'IMG' | 'VIDEO' - `vendor_ids` integer[] ## Response `200` Atomic creative bulk response - object - `data` union[] - union - AtomicCreativeResponse - `id` integer, required - `version` integer, required - `entity_type` string, required - `advertiser_id` integer, required - `concept_id` integer - `concept_name` string - `name` string, required - `width` integer, required - `height` integer, required - `creative_import_file_id` integer - `file_type` string, required - `is_https` boolean, required - `is_multi_creative` boolean, required - `has_sound` boolean, required - `rich_media` boolean, required - `rich_media_provider` string - `status` boolean - `archived` boolean - `built` boolean, required - `build_date` string - `built_by_user_id` integer, nullable - `build_errors` string - `created_on` string, date-time, required - `last_modified` string, required - `external_identifier` string - `tpas_ad_tag_name` string, required - `updated_on` string, date-time, required - `expand` string - `click_url` string - `ad_format` string, required - `expansion_direction` string, required - `expansion_trigger` 'AUTOMATIC' | 'MOUSEOVER' | 'CLICK', required - `ad_server_type` string - `t1as` boolean, required - `tpas_ad_tag` string - `edited_tag` string - `click_through_url` string - `rejected_reason` string - `approval_status` string, required - `start_date` string - `end_date` string - `media_type` string, required - `is_mraid` boolean, required - `vast_version` number, float, nullable - `sizmek_tag_status` string, required - `sizmek_creative_status` string, required - `last_payload_modified` string - `is_audio` boolean - `tag` string - `tag_type` string - AtomicCreativeResponseExtended - `id` integer, required - `version` integer, required - `entity_type` string, required - `advertiser_id` integer, required - `advertiser_name` string: available only when extended - `concept_id` integer - `concept_name` string - `name` string, required - `width` integer, required - `height` integer, required - `creative_import_file_id` integer - `file_type` string, required - `is_https` boolean, required - `is_multi_creative` boolean, required - `has_sound` boolean, required - `rich_media` boolean, required - `rich_media_provider` string - `status` boolean - `archived` boolean - `built` boolean, required - `build_date` string - `built_by_user_id` integer, nullable, required - `build_errors` string - `created_on` string, date-time, required - `last_modified` string, required - `external_identifier` string - `tpas_ad_tag_name` string, required - `updated_on` string, date-time, required - `expand` string - `click_url` string - `ad_format` string, required - `expansion_direction` string, required - `expansion_trigger` 'AUTOMATIC' | 'MOUSEOVER' | 'CLICK', required - `ad_server_type` string - `t1as` boolean, required - `tpas_ad_tag` string - `edited_tag` string - `click_through_url` string - `rejected_reason` string - `approval_status` string, required - `start_date` string - `end_date` string - `media_type` string, required - `is_mraid` boolean, required - `vast_version` number, float, nullable - `sizmek_tag_status` string, required - `sizmek_creative_status` string, required - `last_payload_modified` string - `is_audio` boolean - `tag` string - `tag_type` string - `targeted_strategies` object: available only when extended - `count` integer - `strategies_list` integer[] - `atomic_creative_ssl_validators` object: available only when extended - `is_https` string - `notify_state` string - `ignored` string - `ksize` integer - `vendors` object[]: available only when extended - `id` integer - `name` string - `adx_approved` boolean - `adx_declaration_required` boolean - `mm_contract_available` boolean - `is_eligible` boolean - `adx_ssl_approved` boolean - `adx_video_ssl_approved` boolean - `adx_video_approved` boolean - `auto_tag_display` boolean - `set_by` string - `detect_domains` string[] - `creative_assets` object[]: available only when extended - `id` integer - `name` string - `version` integer - `creative_id` integer - `primary_asset_id` integer - `created_on` string, date-time - `updated_on` string, date-time - `file_name` string - `file_role` string - `file_type` string - `file_storage_path` string - `file_size` integer - `media_version` number, float - `width` integer - `height` integer - `note` string - `inner_tag` string: available only when extended. Contains the original inner tag content for HTML5 creatives. - `meta` ListMetadata - `status` string, required: The status of the response, indicating success or failure. - `count` integer, required: The number of items returned in the current response. - `total_count` integer: The total number of items available in the dataset. - `offset` integer: The offset from the start of the dataset, used for pagination. - `next_page` string: The URL to fetch the next page of results. - `prev_page` string: The URL to fetch the previous page of results. - `errors` object[] - `id` integer - `action` string - `entity_type` string - `index` integer - `errors` object[] - `id` integer - `code` string - `field` string - `message` string ## Other responses - `207`: Atomic creative bulk response - `400`: Error response - `401`: Error response - `403`: Error response --- [API](https://skmtc.dev/mediamath/apis/campaigns-api.md) - [All operations](https://skmtc.dev/mediamath/apis/campaigns-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mediamath/apis/campaigns-api/revisions/408743891def?raw)