Update Insertion Order - Markifact

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