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

> Updates or creates budget segments for DV360 insertion orders

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.