---
title: "Update an insertionorder"
method: PATCH
path: "/ads/{connection_id}/insertionorder/{id}"
tags: ["ads", "insertionorder"]
---

# Update an insertionorder

`PATCH /ads/{connection_id}/insertionorder/{id}`

## Path parameters

- `connection_id` string, required
- `id` string, required

## Query parameters

- `fields` string[]
- `raw` string

## Request body

- AdsInsertionorder
  - `id` string
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `name` string
  - `organization_id` string
  - `campaign_id` string
  - `status` 'UNSPECIFIED' | 'ACTIVE' | 'PAUSED' | 'ARCHIVED' | 'DRAFT' | 'SCHEDULED_FOR_DELETION' | 'PROCESSING' | 'PROCESSING_FAILED'
  - `pacing` PropertyAdsInsertionorderPacing
    - `period` 'UNSPECIFIED' | 'DAILY' | 'FLIGHT'
    - `type` string
    - `daily_max_amount` number
    - `daily_max_impressions` number
  - `frequency_cap` PropertyAdsInsertionorderFrequencyCap
    - `is_unlimited` boolean
    - `time_unit` 'UNSPECIFIED' | 'LIFETIME' | 'MONTHS' | 'WEEKS' | 'DAYS' | 'HOURS' | 'MINUTES'
    - `time_unit_count` number
    - `max_impressions` number
    - `max_views` number
  - `kpi` PropertyAdsInsertionorderKpi
    - `type` 'UNSPECIFIED' | 'CPM' | 'CPC' | 'CPA' | 'CTR' | 'VIEWABILITY' | 'CPIAVC' | 'CPE' | 'CPV' | 'CLICK_CVR' | 'IMPRESSION_CVR' | 'VCPM' | 'VTR' | 'AUDIO_COMPLETION_RATE' | 'VIDEO_COMPLETION_RATE' | 'CPCL' | 'CPCV' | 'TOS10' | 'MAXIMIZE_PACING' | 'CUSTOM_IMPRESSION_VALUE_OVER_COST' | 'OTHER'
    - `amount` number
    - `percentage` number
    - `string_value` string
    - `algorithm_id` string
  - `budget_unit` 'UNSPECIFIED' | 'CURRENCY' | 'IMPRESSIONS'
  - `budget_segments` AdsInsertionorderBudgetSegment[]
    - `budget_amount` number
    - `description` string
    - `start_at` string, date-time
    - `end_at` string, date-time
  - `bid_strategy` PropertyAdsInsertionorderBidStrategy — YOUTUBE_AND_PARTNERS
    - `type` 'FIXED_BID' | 'MAXIMIZE_SPEND' | 'PERFORMANCE_GOAL' | 'YOUTUBE_AND_PARTNERS', required
    - `fixed_bid_amount` number
    - `performance_goal_type` 'UNSPECIFIED' | 'CPA' | 'CPC' | 'VIEWABLE_CPM' | 'CUSTOM_ALGO' | 'CIVA' | 'IVO_TEN' | 'AV_VIEWED' | 'REACH'
    - `performance_goal_amount` number
    - `max_average_cpm_bid_amount` number
    - `custom_bidding_algorithm_id` string
    - `raise_bid_for_deals` boolean
    - `youtube_and_partners_type` 'UNSPECIFIED' | 'MANUAL_CPV' | 'MANUAL_CPM' | 'TARGET_CPA' | 'TARGET_CPM' | 'RESERVE_CPM' | 'MAXIMIZE_LIFT' | 'MAXIMIZE_CONVERSIONS' | 'TARGET_CPV' | 'TARGET_ROAS' | 'MAXIMIZE_CONVERSION_VALUE'
    - `youtube_and_partners_value` string
    - `target_roas` number
  - `reference` string
  - `raw` object

## Response `200`

Successful

- AdsInsertionorder
  - `id` string
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `name` string
  - `organization_id` string
  - `campaign_id` string
  - `status` 'UNSPECIFIED' | 'ACTIVE' | 'PAUSED' | 'ARCHIVED' | 'DRAFT' | 'SCHEDULED_FOR_DELETION' | 'PROCESSING' | 'PROCESSING_FAILED'
  - `pacing` PropertyAdsInsertionorderPacing
    - `period` 'UNSPECIFIED' | 'DAILY' | 'FLIGHT'
    - `type` string
    - `daily_max_amount` number
    - `daily_max_impressions` number
  - `frequency_cap` PropertyAdsInsertionorderFrequencyCap
    - `is_unlimited` boolean
    - `time_unit` 'UNSPECIFIED' | 'LIFETIME' | 'MONTHS' | 'WEEKS' | 'DAYS' | 'HOURS' | 'MINUTES'
    - `time_unit_count` number
    - `max_impressions` number
    - `max_views` number
  - `kpi` PropertyAdsInsertionorderKpi
    - `type` 'UNSPECIFIED' | 'CPM' | 'CPC' | 'CPA' | 'CTR' | 'VIEWABILITY' | 'CPIAVC' | 'CPE' | 'CPV' | 'CLICK_CVR' | 'IMPRESSION_CVR' | 'VCPM' | 'VTR' | 'AUDIO_COMPLETION_RATE' | 'VIDEO_COMPLETION_RATE' | 'CPCL' | 'CPCV' | 'TOS10' | 'MAXIMIZE_PACING' | 'CUSTOM_IMPRESSION_VALUE_OVER_COST' | 'OTHER'
    - `amount` number
    - `percentage` number
    - `string_value` string
    - `algorithm_id` string
  - `budget_unit` 'UNSPECIFIED' | 'CURRENCY' | 'IMPRESSIONS'
  - `budget_segments` AdsInsertionorderBudgetSegment[]
    - `budget_amount` number
    - `description` string
    - `start_at` string, date-time
    - `end_at` string, date-time
  - `bid_strategy` PropertyAdsInsertionorderBidStrategy — YOUTUBE_AND_PARTNERS
    - `type` 'FIXED_BID' | 'MAXIMIZE_SPEND' | 'PERFORMANCE_GOAL' | 'YOUTUBE_AND_PARTNERS', required
    - `fixed_bid_amount` number
    - `performance_goal_type` 'UNSPECIFIED' | 'CPA' | 'CPC' | 'VIEWABLE_CPM' | 'CUSTOM_ALGO' | 'CIVA' | 'IVO_TEN' | 'AV_VIEWED' | 'REACH'
    - `performance_goal_amount` number
    - `max_average_cpm_bid_amount` number
    - `custom_bidding_algorithm_id` string
    - `raise_bid_for_deals` boolean
    - `youtube_and_partners_type` 'UNSPECIFIED' | 'MANUAL_CPV' | 'MANUAL_CPM' | 'TARGET_CPA' | 'TARGET_CPM' | 'RESERVE_CPM' | 'MAXIMIZE_LIFT' | 'MAXIMIZE_CONVERSIONS' | 'TARGET_CPV' | 'TARGET_ROAS' | 'MAXIMIZE_CONVERSION_VALUE'
    - `youtube_and_partners_value` string
    - `target_roas` number
  - `reference` string
  - `raw` object

---

[API](https://skmtc.net/unified/apis/unified-to-api.md) · [All operations](https://skmtc.net/unified/apis/unified-to-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/unified/unified-to-api/versions/1f72720916e4/schema)