Create Line Item

Creates a DV360 line item under an insertion order with type, flight, budget, pacing, frequency cap, bid strategy, and partner revenue model. Budget and spend amounts are entered in the advertiser’s currency; the raw bid_strategy and partner_revenue_model objects use raw micros as in the DV360 API. YouTube & Partners line items cannot be created via the API. Created as a draft; activate with dv360_update_line_item_status.


App	DV360
Operation ID	`dv360_create_line_item`
Type	Action
Connection	`dv360` (required)
Credits per run	2
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 the line item belongs to.
`line_item_name`	string	Yes	-	Display name of the line item. Max 240 bytes.
`line_item_type`	string or SelectableOption	Yes	-	Line item type: DISPLAY_DEFAULT, DISPLAY_MOBILE_APP_INSTALL, VIDEO_DEFAULT, VIDEO_MOBILE_APP_INSTALL, AUDIO_DEFAULT, VIDEO_OVER_THE_TOP, or DEMAND_GEN. YouTube & Partners and out-of-home types cannot be created via the DV360 API.
`flight_date_type`	string or SelectableOption	No	`{'value': 'INHERITED', 'label': 'Inherit from insertion order'}`	INHERITED (default) uses the parent insertion order’s flight dates; CUSTOM uses start_date and end_date.
`start_date`	string	No	-	Flight start date as YYYY-MM-DD. Required when flight_date_type is CUSTOM.
`end_date`	string	No	-	Flight end date as YYYY-MM-DD. Required when flight_date_type is CUSTOM.
`budget_allocation_type`	string or SelectableOption	No	`{'value': 'FIXED', 'label': 'Fixed'}`	FIXED (default) uses max_budget_amount; AUTOMATIC requires automatic budget allocation on the parent insertion order; UNLIMITED has no budget limit. Demand Gen line items must use FIXED.
`max_budget_amount`	number	No	-	Maximum budget in the advertiser’s currency; converted to DV360 micros automatically. Required when budget_allocation_type is FIXED.
`pacing_period`	string or SelectableOption	No	`{'value': 'DAILY', 'label': 'Daily'}`	Budget spending window: DAILY (default) or FLIGHT.
`pacing_type`	string or SelectableOption	No	`{'value': 'EVEN', 'label': 'Even'}`	Spending speed: EVEN (default), AHEAD (flight pacing only), or ASAP (with daily pacing, requires daily_max_spend).
`daily_max_spend`	number	No	-	Daily maximum spend in the advertiser’s currency; converted to micros automatically. With daily pacing, provide this or daily_max_impressions, not both.
`daily_max_impressions`	integer	No	-	Daily maximum impressions. With daily pacing, provide this or daily_max_spend, not both.
`bid_strategy`	object or string	Yes	-	Official DV360 BidStrategy object as JSON, sent as-is with raw micros. Exactly one of: fixedBid, maximizeSpendAutoBid, or performanceGoalAutoBid. Examples: {“fixedBid”: {“bidAmountMicros”: “1500000”}} for a fixed $1.50 bid; {“maximizeSpendAutoBid”: {“performanceGoalType”: “BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPC”}}; {“performanceGoalAutoBid”: {“performanceGoalType”: “BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPA”, “performanceGoalAmountMicros”: “10000000”}}.
`partner_revenue_model`	object or string	Yes	-	Official DV360 PartnerRevenueModel object as JSON, sent as-is. Keys: markupType (PARTNER_REVENUE_MODEL_MARKUP_TYPE_CPM or PARTNER_REVENUE_MODEL_MARKUP_TYPE_TOTAL_MEDIA_COST_MARKUP) and markupAmount (raw units: micros of the advertiser currency for CPM, for example 1500000 = 1.5; millis of percent for markup types, for example 100 = 0.1%). Demand Gen line items must use TOTAL_MEDIA_COST_MARKUP. For no markup use {“markupType”: “PARTNER_REVENUE_MODEL_MARKUP_TYPE_TOTAL_MEDIA_COST_MARKUP”, “markupAmount”: “0”}.
`conversion_counting`	object or string	No	-	Optional official DV360 ConversionCountingConfig object as JSON, sent as-is (postViewCountPercentageMillis and floodlightActivityConfigs with raw millis values).
`mobile_app_id`	string	No	-	App platform ID (for example com.example.app for Android or 422689480 for iOS). Required for DISPLAY_MOBILE_APP_INSTALL and VIDEO_MOBILE_APP_INSTALL line items; sent as mobileApp.appId.
`creative_ids`	array of string (also accepts a comma-separated string)	No	-	Optional DV360 creative IDs to assign, as a list or comma-separated text.
`unlimited_frequency_cap`	boolean	No	`True`	When true (default), no line-item frequency cap. Set false to cap impressions per user with the frequency_cap_* fields.
`frequency_cap_max_impressions`	integer	No	-	Maximum impressions per user for the chosen time window. Required when unlimited_frequency_cap is false.
`frequency_cap_time_unit`	string or SelectableOption	No	-	Frequency cap window unit: LIFETIME, MONTHS, WEEKS, DAYS, HOURS, or MINUTES. Required when unlimited_frequency_cap is false.
`frequency_cap_time_unit_count`	integer	No	-	How many time units the window lasts. Required when unlimited_frequency_cap is false, except for LIFETIME.

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.

SelectableOption

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

Output

Type: Dict Returns the created DV360 line item details. Fields: line_item_id, line_item_name, entity_status, insertion_order_id, advertiser_id, line_item

Get Started

Guides

Operations

Inputs

SelectItem

SelectableOption

Output

​Inputs

​SelectItem

​SelectableOption

​Output

Inputs

SelectItem

SelectableOption

Output