Update Insertion Order Budget - Markifact

Updates or creates budget segments for DV360 insertion orders


App	DV360
Operation ID	`dv360_update_insertion_order_budget`
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 DV360 advertiser account
`update_type`	string or SelectableOption	Yes	-	Choose whether to update a single insertion order or multiple at once. Options: ‘single’ (Single Update), ‘bulk’ (Bulk Updates)
`budget_mode`	string or SelectableOption	No	-	‘edit’ modifies the in-flight segment (or the only segment if just one exists). ‘create’ adds a new budget period. Options: ‘edit’ (Edit Current Segment), ‘create’ (Create New Segment). Required for single update, included per row for bulk.
`insertion_order_id`	string	No	-	The insertion order ID to update (required for single update)
`budget_amount`	number	No	-	Budget amount in standard units. For currency-based budgets: e.g., 5000 for $5,000. For impression-based budgets: e.g., 5000 for 5,000 impressions. Value is converted to micros (×1,000,000) before sending to API.
`end_date`	string	No	-	End date in YYYY-MM-DD format (required for ‘create’ mode, optional for ‘edit’ mode)
`start_date`	string	No	-	Start date in YYYY-MM-DD format (required for ‘create’ mode)
`structured_data`	array (also accepts a comma-separated string)	No	-	Structured data for bulk updates. Required fields: ‘insertion_order_id’, ‘budget_mode’ (‘edit’ or ‘create’). For ‘edit’ mode: at least one of ‘budget_amount’ or ‘end_date’. For ‘create’ mode: ‘budget_amount’, ‘start_date’, and ‘end_date’ are all required.

SelectableOption

Field	Type	Required	Default	Description
`value`	string	Yes	-
`label`	string	Yes	-

Output

Type: str Returns success message confirming budget update.