# Update a Campaign

Update a campaign by ID

Endpoint: POST /campaigns/{campaign_id}
Version: 3.0.1807
Security: Auth0

## Path parameters:

  - `campaign_id` (integer, required)
    Numeric ID of the campaign to update

## Request fields (application/json):

  - `archived` (boolean)

  - `status` (boolean)

  - `name` (string)

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

  - `io_name` (string)

  - `io_reference_num` (string)

  - `is_programmatic_guaranteed` (boolean)

  - `political` (boolean)

  - `source_campaign_id` (integer,null)
    Example: 7

  - `zone_name` (string)

  - `viewability` (object,null)

  - `viewability.vendor_id` (integer, required)
    Example: 34

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

  - `viewability.sample_rate` (number, required)

  - `identity` (object)

  - `identity.device_graph_only` (boolean)

  - `identity.bid_min_devices` (integer)

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

  - `ad_server` (object)

  - `ad_server.ad_server_id` (integer)
    Example: 19

  - `ad_server.ad_server_username` (string)

  - `ad_server.ad_server_password` (string)

  - `ad_server.use_default_ad_server` (boolean)

  - `ad_server.ad_server_fee` (number)

  - `pacing` (object)

  - `pacing.pacing_alert` (number)

  - `pacing.impression_cap_automatic` (boolean)

  - `pacing.impression_cap_amount` (integer,null)
    Example: 11

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

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

  - `pacing.spend_cap_amount` (number,null)

  - `pacing.spend_cap_automatic` (boolean)

  - `pacing.brain_intraday_pacing` (boolean)

  - `pacing.spend_pace_ahead` (boolean)
    feature still in development

  - `pacing.impression_pace_ahead` (boolean)
    feature still in development

  - `attribution` (object)

  - `attribution.has_custom_attribution` (boolean)

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

  - `attribution.pc_window_minutes` (integer)
    Example: 5

  - `attribution.pv_window_minutes` (integer)
    Example: 6

  - `attribution.pv_pct` (number)

  - `attribution.merit_pixel_id` (integer,null)
    Example: 17

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

  - `attribution.conversion_variable_minutes` (integer)
    Example: 1

  - `vendor_contracts` (array)

  - `vendor_contracts.vendor_id` (integer, required)
    Example: 23

  - `vendor_contracts.use_mm_contract` (boolean)

  - `vendor_contracts.price` (number,null)

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

  - `mfa_avoidance` (string)
    Enum: "INHERIT", "ALLOW_ALL", "EXCLUDE_MFA"

  - `targeting_identity_level` (string)
    Enum: "INHERIT", "INDIVIDUAL", "HOUSEHOLD"

  - `version` (integer)
    Example: 4

  - `goals` (object)

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

  - `goals.goal_alert` (number)

  - `goals.goal_value` (number)

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

  - `budget` (object)

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

  - `budget.margin_pct` (number)

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

  - `budget.dynamic_budget_allocation_applied` (string)

  - `budget.dynamic_budget_allocation_available` (string)

  - `budget.flights` (array, required)

  - `budget.flights.id` (integer)
    Example: 77

  - `budget.flights.start_date` (string)

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

  - `budget.flights.total_budget` (number)

  - `budget.flights.total_impression_budget` (integer,null)
    Example: 12345

  - `budget.total_budget` (number,null)

  - `budget.total_impression_budget` (integer,null)
    Example: 18789

  - `frequency` (object)

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

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

  - `frequency.frequency_amount` (integer,null)
    Example: 10

  - `frequency.frequency_optimization` (boolean)

  - `frequency.use_mm_freq` (boolean)

  - `inventory` (object)

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

  - `inventory.minimize_multi_ads` (boolean)

  - `inventory.override_suspicious_traffic_filter` (boolean)

  - `inventory.suspicious_traffic_filter_level` (integer)

  - `inventory.dcs_data_is_campaign_level` (boolean)

  - `inventory.restrict_targeting_to_same_device_id` (boolean)

  - `inventory.restrict_targeting_to_deterministic_id` (boolean)

  - `site_lists` (array)

  - `site_lists.id` (integer, required)
    Example: 23

  - `site_lists.assigned` (boolean, required)

  - `custom_brain_selections` (array)

  - `custom_brain_selections.selection_id` (integer)
    Example: 45

  - `custom_brain_selections.selection_type` (any)
    Enum: "Audience Target", "Data Pixel", "Event Pixel", "Segment", "Dynamic"

## Response 200 fields (application/json):

  - `data` (object)

  - `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)
    Example: 7

  - `data.zone_name` (string)

  - `data.viewability` (object,null)

  - `data.viewability.vendor_id` (integer, required)
    Example: 34

  - `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)
    Example: 19

  - `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)
    Example: 11

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

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

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

  - `data.pacing.spend_cap_automatic` (boolean)

  - `data.pacing.brain_intraday_pacing` (boolean)

  - `data.pacing.spend_pace_ahead` (boolean)
    feature still in development

  - `data.pacing.impression_pace_ahead` (boolean)
    feature still in development

  - `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)
    Example: 5

  - `data.attribution.pv_window_minutes` (integer)
    Example: 6

  - `data.attribution.pv_pct` (number)

  - `data.attribution.merit_pixel_id` (integer,null)
    Example: 17

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

  - `data.attribution.conversion_variable_minutes` (integer)
    Example: 1

  - `data.vendor_contracts` (array)

  - `data.vendor_contracts.vendor_id` (integer, required)
    Example: 23

  - `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.mfa_avoidance` (string)
    Enum: "INHERIT", "ALLOW_ALL", "EXCLUDE_MFA"

  - `data.targeting_identity_level` (string)
    Enum: "INHERIT", "INDIVIDUAL", "HOUSEHOLD"

  - `data.id` (integer)

  - `data.version` (integer)

  - `data.advertiser_id` (integer)

  - `data.created_on` (string)

  - `data.updated_on` (string)

  - `data.locked_on` (string,null)

  - `data.v3_usage` (boolean)

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

  - `data.duration.start_date` (string)

  - `data.duration.end_date` (string)

  - `data.duration.initial_start_date` (string)

  - `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.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.id` (integer)
    Example: 77

  - `data.budget.flights.start_date` (string)

  - `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)
    Example: 12345

  - `data.budget.flights.is_relevant` (boolean)

  - `data.budget.total_budget` (number,null)

  - `data.budget.total_impression_budget` (integer,null)
    Example: 18789

  - `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", "not-applicable"

  - `data.frequency.frequency_amount` (integer,null)
    Example: 10

  - `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.effective_ads_txt_verified` (string)
    Enum: "ANY", "AUTHORIZED_ONLY", "AUTHORIZED_DIRECT_ONLY", "NONE"

  - `data.inventory.restrict_targeting_to_deterministic_id` (boolean)

  - `data.site_lists` (array)

  - `data.site_lists.id` (integer)

  - `data.site_lists.name` (string)

  - `data.site_lists.version` (integer)

  - `data.site_lists.status` (boolean)

  - `data.site_lists.organization_id` (integer)

  - `data.site_lists.created_on` (string)

  - `data.site_lists.updated_on` (string)

  - `data.site_lists.restriction` (string)

  - `data.site_lists.filename` (string)

  - `data.site_lists.campaign_id` (integer)

  - `data.site_lists.assigned` (boolean)

  - `data.site_lists.sites_count` (integer)

  - `data.site_lists.sites_count_app` (integer)

  - `data.site_lists.sites_count_domain` (integer)

  - `data.site_lists.sites_count_primary_seller_id` (integer)

  - `data.custom_brain_selections` (array)

  - `data.custom_brain_selections.id` (integer)

  - `data.custom_brain_selections.version` (integer)

  - `data.custom_brain_selections.campaign_id` (integer)

  - `data.custom_brain_selections.selection_id` (integer)

  - `data.custom_brain_selections.selection_type` (string)

  - `data.custom_brain_selections.active` (boolean)

  - `data.custom_brain_selections.enable_mm_audiences_in_brain` (boolean)

  - `data.custom_brain_selections.is_retired` (boolean)

  - `data.custom_brain_selections.full_path` (string)

  - `data.custom_brain_selections.owner_name` (string)

  - `data.custom_brain_selections.selection_name` (string)

  - `data.custom_brain_selections.child_count` (integer)

  - `data.custom_brain_selections.parent_audience_segment_id` (integer)

  - `data.custom_brain_selections.retail_cpm` (number)

  - `data.custom_brain_selections.uniques` (integer)

  - `data.custom_brain_selections.wholesale_cpm` (number)

  - `data.strategies` (object)

  - `data.strategies.count` (integer)

  - `data.strategies.strategies_list` (array)

  - `data.strategies.distinct_strategy_goal_types` (array)
    Enum: "spend", "reach", "cpc", "cpe", "cpa", "roi", "ctr", "vcr", "viewability_rate", "vcpm", "cpcv"

  - `data.strategy_groups` (object)

  - `data.strategy_groups.count` (integer)

  - `data.strategy_groups.strategy_groups_list` (array)

  - `data.inherited_mfa_avoidance` (string)
    available if mfa_avoidance = INHERIT
    Enum: "INHERIT", "ALLOW_ALL", "EXCLUDE_MFA"

  - `data.inherited_mfa_from` (string)
    available if mfa_avoidance = INHERIT
    Enum: "Organization", "Agency", "Advertiser", "Campaign"

  - `data.inherited_targeting_identity_level` (string)
    available if targeting_identity_level = INHERIT
    Enum: "INDIVIDUAL", "HOUSEHOLD"

  - `meta` (object)

  - `meta.status` (string, required)
    Example: "success"

## 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)

## Response 404 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 409 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)