> ## Documentation Index
> Fetch the complete documentation index at: https://docs.markifact.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Update Insertion Order

> Advanced: partially updates a DV360 insertion order from a raw v4 field payload with an update mask; only masked fields change and micros values are raw

Advanced: partially updates a DV360 insertion order from a raw v4 field payload with an update mask; only masked fields change and micros values are raw. The mask is derived from the payload when omitted. Prefer the dedicated operations (dv360\_update\_insertion\_order\_status, dv360\_update\_insertion\_order\_budget) for simple changes. Supports dry\_run.

|                       |                                |
| --------------------- | ------------------------------ |
| **App**               | DV360                          |
| **Operation ID**      | `dv360_update_insertion_order` |
| **Type**              | Action                         |
| **Connection**        | `dv360` (required)             |
| **Credits per run**   | 1                              |
| **Agent / MCP tool**  | Yes                            |
| **Requires approval** | Yes (write operation)          |

## Inputs

| Field                | Type                 | Required | Default | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| -------------------- | -------------------- | -------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `account`            | DynamicAccount       | Yes      | -       | Select the DV360 advertiser that owns the insertion order.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| `insertion_order_id` | string or SelectItem | Yes      | -       | ID of the DV360 insertion order to update. Do not repeat it inside update\_payload.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| `update_payload`     | object or string     | Yes      | -       | Insertion order fields to update as a JSON object using the official DV360 v4 camelCase field names, sent as-is with raw micros values. Only the fields named in the update mask are changed. Common editable fields: displayName, kpi, pacing (dailyMaxMicros raw), budget (budgetSegments with budgetAmountMicros raw), bidStrategy, optimizationObjective, frequencyCap, and entityStatus. Prefer the dedicated operations (dv360\_update\_insertion\_order\_status and dv360\_update\_insertion\_order\_budget) for simple changes. Example: \{"pacing": \{"pacingPeriod": "PACING\_PERIOD\_DAILY", "pacingType": "PACING\_TYPE\_EVEN", "dailyMaxMicros": "200000000"}} |
| `update_mask`        | string               | No       | -       | Optional comma-separated DV360 update mask. When omitted, it is derived from the top-level keys of update\_payload. Provide it explicitly for nested masks, for example campaignFlight.plannedDates or budget.budgetSegments.                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| `dry_run`            | boolean              | No       | `False` | When true, do not call DV360. Return the resolved update mask and payload for review.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |

### SelectItem

| Field   | Type   | Required | Default | Description                                                                                          |
| ------- | ------ | -------- | ------- | ---------------------------------------------------------------------------------------------------- |
| `value` | string | Yes      | -       | The value of the selectable item.                                                                    |
| `label` | string | Yes      | -       | The label of the selectable item, used for display purposes. If not provided, defaults to the value. |

## Output

**Type**: `Dict`

Returns the update mask, payload, and updated insertion order.

**Fields**: `insertion_order_id`, `update_mask`, `payload`, `dry_run`