# Bulk Update Campaigns

Update multiple campaigns

Endpoint: POST /bulk_update/campaigns
Version: xx.xx.xx
Security: Auth0

## Request fields (application/json):

  - `update` (array, required)

  - `update.archived` (boolean)

  - `update.status` (boolean)

  - `update.name` (string)

  - `update.service_type` (string)
    Enum: "SELF", "MANAGED"

  - `update.io_name` (string)

  - `update.io_reference_num` (string)

  - `update.is_programmatic_guaranteed` (boolean)

  - `update.political` (boolean)

  - `update.source_campaign_id` (integer,null)

  - `update.zone_name` (string)

  - `update.viewability` (object,null)

  - `update.viewability.vendor_id` (integer, required)

  - `update.viewability.type` (string, required)
    Enum: "AUTO_TAG", "BYOV"

  - `update.viewability.sample_rate` (number, required)

  - `update.identity` (object)

  - `update.identity.device_graph_only` (boolean)

  - `update.identity.bid_min_devices` (integer)

  - `update.identity.connected_id_type` (string,null)
    Enum: "DETERMINISTIC_FIRST"

  - `update.ad_server` (object)

  - `update.ad_server.ad_server_id` (integer)

  - `update.ad_server.ad_server_username` (string)

  - `update.ad_server.ad_server_password` (string)

  - `update.ad_server.use_default_ad_server` (boolean)

  - `update.ad_server.ad_server_fee` (number)

  - `update.pacing` (object)

  - `update.pacing.pacing_alert` (number)

  - `update.pacing.impression_cap_automatic` (boolean)

  - `update.pacing.impression_cap_amount` (integer,null)

  - `update.pacing.impression_cap_type` (string)
    Enum: "even", "asap", "no-limit", "t1-optimized"

  - `update.pacing.spend_cap_type` (string)
    Enum: "even", "asap", "no-limit", "t1-optimized"

  - `update.pacing.spend_cap_amount` (number,null)

  - `update.pacing.spend_cap_automatic` (boolean)

  - `update.pacing.brain_intraday_pacing` (boolean)

  - `update.attribution` (object)

  - `update.attribution.has_custom_attribution` (boolean)

  - `update.attribution.custom_attribution_source` (string,null)
    Enum: "3rd Party Attribution", "T1 MTA via Neustar"

  - `update.attribution.pc_window_minutes` (integer)

  - `update.attribution.pv_window_minutes` (integer)

  - `update.attribution.pv_pct` (number)

  - `update.attribution.merit_pixel_id` (integer,null)

  - `update.attribution.conversion_type` (string)
    Enum: "every", "one", "variable"

  - `update.attribution.conversion_variable_minutes` (integer)

  - `update.vendor_contracts` (array)

  - `update.vendor_contracts.use_mm_contract` (boolean)

  - `update.vendor_contracts.price` (number,null)

  - `update.vendor_contracts.rate_card_type` (string,null)
    Enum: "CPM", "FIXED"

  - `update.id` (integer, required)

  - `update.goals` (object)

  - `update.goals.goal_type` (string)
    Enum: "spend", "reach", "cpc", "cpe", "cpa", "roi", "ctr", "vcr", "viewability_rate", "vcpm", "cpcv"

  - `update.goals.goal_alert` (number)

  - `update.goals.goal_value` (number)

  - `update.goals.goal_category` (string,null)
    Enum: "audience", "engagement", "response"

  - `update.duration` (object)
    Duration of campaigns must not exceed 36 months

  - `update.duration.start_date` (string)

  - `update.duration.end_date` (string)

  - `update.budget` (object)

  - `update.budget.currency_code` (string)
    Example: "USD"

  - `update.budget.margin_pct` (number)

  - `update.budget.dynamic_budget_allocation_type` (string)
    Enum: "SBA_AUTO_ALLOCATION", "SBA_RECOMMENDATIONS_ONLY", "OFF"

  - `update.budget.dynamic_budget_allocation_applied` (string)

  - `update.budget.dynamic_budget_allocation_available` (string)

  - `update.budget.flights` (array)

  - `update.budget.flights.end_date` (string)
    The latest end date of flight must be no more than 36 months after the earliest start date

  - `update.budget.flights.total_budget` (number)

  - `update.budget.flights.total_impression_budget` (integer,null)

  - `update.frequency` (object)

  - `update.frequency.frequency_type` (string)
    Enum: "even", "asap", "no-limit", "t1-optimized", "frequency_goal"

  - `update.frequency.frequency_interval` (string,null)
    Enum: "hour", "day", "week", "month", "campaign", "not-applicable"

  - `update.frequency.frequency_amount` (integer,null)

  - `update.frequency.frequency_optimization` (boolean)

  - `update.frequency.use_mm_freq` (boolean)

  - `update.inventory` (object)

  - `update.inventory.ads_txt_verified` (string,null)
    Enum: "ANY", "AUTHORIZED_ONLY", "AUTHORIZED_DIRECT_ONLY", "NONE"

  - `update.inventory.minimize_multi_ads` (boolean)

  - `update.inventory.override_suspicious_traffic_filter` (boolean)

  - `update.inventory.suspicious_traffic_filter_level` (integer)

  - `update.inventory.dcs_data_is_campaign_level` (boolean)

  - `update.inventory.restrict_targeting_to_same_device_id` (boolean)

  - `update.inventory.restrict_targeting_to_deterministic_id` (boolean)

## Response 200 fields (application/json):

  - `data` (array)

  - `data.archived` (boolean)

  - `data.status` (boolean)

  - `data.name` (string)

  - `data.service_type` (string)
    Enum: "SELF", "MANAGED"

  - `data.io_name` (string)

  - `data.io_reference_num` (string)

  - `data.is_programmatic_guaranteed` (boolean)

  - `data.political` (boolean)

  - `data.source_campaign_id` (integer,null)

  - `data.zone_name` (string)

  - `data.viewability` (object,null)

  - `data.viewability.vendor_id` (integer, required)

  - `data.viewability.type` (string, required)
    Enum: "AUTO_TAG", "BYOV"

  - `data.viewability.sample_rate` (number, required)

  - `data.identity` (object)

  - `data.identity.device_graph_only` (boolean)

  - `data.identity.bid_min_devices` (integer)

  - `data.identity.connected_id_type` (string,null)
    Enum: "DETERMINISTIC_FIRST"

  - `data.ad_server` (object)

  - `data.ad_server.ad_server_id` (integer)

  - `data.ad_server.ad_server_username` (string)

  - `data.ad_server.ad_server_password` (string)

  - `data.ad_server.use_default_ad_server` (boolean)

  - `data.ad_server.ad_server_fee` (number)

  - `data.pacing` (object)

  - `data.pacing.pacing_alert` (number)

  - `data.pacing.impression_cap_automatic` (boolean)

  - `data.pacing.impression_cap_amount` (integer,null)

  - `data.pacing.impression_cap_type` (string)
    Enum: "even", "asap", "no-limit", "t1-optimized"

  - `data.pacing.spend_cap_type` (string)
    Enum: "even", "asap", "no-limit", "t1-optimized"

  - `data.pacing.spend_cap_amount` (number,null)

  - `data.pacing.spend_cap_automatic` (boolean)

  - `data.pacing.brain_intraday_pacing` (boolean)

  - `data.attribution` (object)

  - `data.attribution.has_custom_attribution` (boolean)

  - `data.attribution.custom_attribution_source` (string,null)
    Enum: "3rd Party Attribution", "T1 MTA via Neustar"

  - `data.attribution.pc_window_minutes` (integer)

  - `data.attribution.pv_window_minutes` (integer)

  - `data.attribution.pv_pct` (number)

  - `data.attribution.merit_pixel_id` (integer,null)

  - `data.attribution.conversion_type` (string)
    Enum: "every", "one", "variable"

  - `data.attribution.conversion_variable_minutes` (integer)

  - `data.vendor_contracts` (array)

  - `data.vendor_contracts.use_mm_contract` (boolean)

  - `data.vendor_contracts.price` (number,null)

  - `data.vendor_contracts.rate_card_type` (string,null)
    Enum: "CPM", "FIXED"

  - `data.id` (integer, required)

  - `data.goals` (object)

  - `data.goals.goal_type` (string)
    Enum: "spend", "reach", "cpc", "cpe", "cpa", "roi", "ctr", "vcr", "viewability_rate", "vcpm", "cpcv"

  - `data.goals.goal_alert` (number)

  - `data.goals.goal_value` (number)

  - `data.goals.goal_category` (string,null)
    Enum: "audience", "engagement", "response"

  - `data.duration` (object)
    Duration of campaigns must not exceed 36 months

  - `data.duration.start_date` (string)

  - `data.duration.end_date` (string)

  - `data.budget` (object)

  - `data.budget.currency_code` (string)
    Example: "USD"

  - `data.budget.margin_pct` (number)

  - `data.budget.dynamic_budget_allocation_type` (string)
    Enum: "SBA_AUTO_ALLOCATION", "SBA_RECOMMENDATIONS_ONLY", "OFF"

  - `data.budget.dynamic_budget_allocation_applied` (string)

  - `data.budget.dynamic_budget_allocation_available` (string)

  - `data.budget.flights` (array)

  - `data.budget.flights.end_date` (string)
    The latest end date of flight must be no more than 36 months after the earliest start date

  - `data.budget.flights.total_budget` (number)

  - `data.budget.flights.total_impression_budget` (integer,null)

  - `data.frequency` (object)

  - `data.frequency.frequency_type` (string)
    Enum: "even", "asap", "no-limit", "t1-optimized", "frequency_goal"

  - `data.frequency.frequency_interval` (string,null)
    Enum: "hour", "day", "week", "month", "campaign", "not-applicable"

  - `data.frequency.frequency_amount` (integer,null)

  - `data.frequency.frequency_optimization` (boolean)

  - `data.frequency.use_mm_freq` (boolean)

  - `data.inventory` (object)

  - `data.inventory.ads_txt_verified` (string,null)
    Enum: "ANY", "AUTHORIZED_ONLY", "AUTHORIZED_DIRECT_ONLY", "NONE"

  - `data.inventory.minimize_multi_ads` (boolean)

  - `data.inventory.override_suspicious_traffic_filter` (boolean)

  - `data.inventory.suspicious_traffic_filter_level` (integer)

  - `data.inventory.dcs_data_is_campaign_level` (boolean)

  - `data.inventory.restrict_targeting_to_same_device_id` (boolean)

  - `data.inventory.restrict_targeting_to_deterministic_id` (boolean)

  - `meta` (object)

  - `meta.status` (string, required)
    The status of the response, indicating success or failure.
    Example: "success"

  - `meta.count` (integer, required)
    The number of items returned in the current response.
    Example: 10

  - `meta.total_count` (integer)
    The total number of items available in the dataset.
    Example: 100

  - `meta.offset` (integer)
    The offset from the start of the dataset, used for pagination.

  - `meta.next_page` (string)
    The URL to fetch the next page of results.

  - `meta.prev_page` (string)
    The URL to fetch the previous page of results.

## Response 207 fields (application/json):

  - `data` (array)

  - `data.archived` (boolean)

  - `data.status` (boolean)

  - `data.name` (string)

  - `data.service_type` (string)
    Enum: "SELF", "MANAGED"

  - `data.io_name` (string)

  - `data.io_reference_num` (string)

  - `data.is_programmatic_guaranteed` (boolean)

  - `data.political` (boolean)

  - `data.source_campaign_id` (integer,null)

  - `data.zone_name` (string)

  - `data.viewability` (object,null)

  - `data.viewability.vendor_id` (integer, required)

  - `data.viewability.type` (string, required)
    Enum: "AUTO_TAG", "BYOV"

  - `data.viewability.sample_rate` (number, required)

  - `data.identity` (object)

  - `data.identity.device_graph_only` (boolean)

  - `data.identity.bid_min_devices` (integer)

  - `data.identity.connected_id_type` (string,null)
    Enum: "DETERMINISTIC_FIRST"

  - `data.ad_server` (object)

  - `data.ad_server.ad_server_id` (integer)

  - `data.ad_server.ad_server_username` (string)

  - `data.ad_server.ad_server_password` (string)

  - `data.ad_server.use_default_ad_server` (boolean)

  - `data.ad_server.ad_server_fee` (number)

  - `data.pacing` (object)

  - `data.pacing.pacing_alert` (number)

  - `data.pacing.impression_cap_automatic` (boolean)

  - `data.pacing.impression_cap_amount` (integer,null)

  - `data.pacing.impression_cap_type` (string)
    Enum: "even", "asap", "no-limit", "t1-optimized"

  - `data.pacing.spend_cap_type` (string)
    Enum: "even", "asap", "no-limit", "t1-optimized"

  - `data.pacing.spend_cap_amount` (number,null)

  - `data.pacing.spend_cap_automatic` (boolean)

  - `data.pacing.brain_intraday_pacing` (boolean)

  - `data.attribution` (object)

  - `data.attribution.has_custom_attribution` (boolean)

  - `data.attribution.custom_attribution_source` (string,null)
    Enum: "3rd Party Attribution", "T1 MTA via Neustar"

  - `data.attribution.pc_window_minutes` (integer)

  - `data.attribution.pv_window_minutes` (integer)

  - `data.attribution.pv_pct` (number)

  - `data.attribution.merit_pixel_id` (integer,null)

  - `data.attribution.conversion_type` (string)
    Enum: "every", "one", "variable"

  - `data.attribution.conversion_variable_minutes` (integer)

  - `data.vendor_contracts` (array)

  - `data.vendor_contracts.use_mm_contract` (boolean)

  - `data.vendor_contracts.price` (number,null)

  - `data.vendor_contracts.rate_card_type` (string,null)
    Enum: "CPM", "FIXED"

  - `data.id` (integer, required)

  - `data.goals` (object)

  - `data.goals.goal_type` (string)
    Enum: "spend", "reach", "cpc", "cpe", "cpa", "roi", "ctr", "vcr", "viewability_rate", "vcpm", "cpcv"

  - `data.goals.goal_alert` (number)

  - `data.goals.goal_value` (number)

  - `data.goals.goal_category` (string,null)
    Enum: "audience", "engagement", "response"

  - `data.duration` (object)
    Duration of campaigns must not exceed 36 months

  - `data.duration.start_date` (string)

  - `data.duration.end_date` (string)

  - `data.budget` (object)

  - `data.budget.currency_code` (string)
    Example: "USD"

  - `data.budget.margin_pct` (number)

  - `data.budget.dynamic_budget_allocation_type` (string)
    Enum: "SBA_AUTO_ALLOCATION", "SBA_RECOMMENDATIONS_ONLY", "OFF"

  - `data.budget.dynamic_budget_allocation_applied` (string)

  - `data.budget.dynamic_budget_allocation_available` (string)

  - `data.budget.flights` (array)

  - `data.budget.flights.end_date` (string)
    The latest end date of flight must be no more than 36 months after the earliest start date

  - `data.budget.flights.total_budget` (number)

  - `data.budget.flights.total_impression_budget` (integer,null)

  - `data.frequency` (object)

  - `data.frequency.frequency_type` (string)
    Enum: "even", "asap", "no-limit", "t1-optimized", "frequency_goal"

  - `data.frequency.frequency_interval` (string,null)
    Enum: "hour", "day", "week", "month", "campaign", "not-applicable"

  - `data.frequency.frequency_amount` (integer,null)

  - `data.frequency.frequency_optimization` (boolean)

  - `data.frequency.use_mm_freq` (boolean)

  - `data.inventory` (object)

  - `data.inventory.ads_txt_verified` (string,null)
    Enum: "ANY", "AUTHORIZED_ONLY", "AUTHORIZED_DIRECT_ONLY", "NONE"

  - `data.inventory.minimize_multi_ads` (boolean)

  - `data.inventory.override_suspicious_traffic_filter` (boolean)

  - `data.inventory.suspicious_traffic_filter_level` (integer)

  - `data.inventory.dcs_data_is_campaign_level` (boolean)

  - `data.inventory.restrict_targeting_to_same_device_id` (boolean)

  - `data.inventory.restrict_targeting_to_deterministic_id` (boolean)

  - `meta` (object)

  - `meta.status` (string, required)
    The status of the response, indicating success or failure.
    Example: "success"

  - `meta.count` (integer, required)
    The number of items returned in the current response.
    Example: 10

  - `meta.total_count` (integer)
    The total number of items available in the dataset.
    Example: 100

  - `meta.offset` (integer)
    The offset from the start of the dataset, used for pagination.

  - `meta.next_page` (string)
    The URL to fetch the next page of results.

  - `meta.prev_page` (string)
    The URL to fetch the previous page of results.

## Response 400 fields (application/json):

  - `errors` (array, required)

  - `errors.code` (string)

  - `errors.field` (string)
    Optional when it is a schema error

  - `errors.message` (string)

  - `meta` (object, required)

  - `meta.status` (string, required)

## Response 401 fields (application/json):

  - `errors` (array, required)

  - `errors.code` (string)

  - `errors.field` (string)
    Optional when it is a schema error

  - `errors.message` (string)

  - `meta` (object, required)

  - `meta.status` (string, required)

## Response 403 fields (application/json):

  - `errors` (array, required)

  - `errors.code` (string)

  - `errors.field` (string)
    Optional when it is a schema error

  - `errors.message` (string)

  - `meta` (object, required)

  - `meta.status` (string, required)