Skip to content

Create Insertion Orders

Request

Create up to 100 new insertion orders in a single request.

This endpoint is transactional. If the request succeeds, all insertion orders are created. If the request fails, no insertion orders are created.

Security
SessionCookie
Bodyapplication/jsonrequired
insertion_ordersArray of objects(api.dsp.v1.CreateInsertionOrderRequest)
curl -i -X POST \
  https://platform-api.vistarmedia.com/api/dsp/v1/insertion_orders \
  -H 'Content-Type: application/json' \
  -H 'Cookie: YOUR_API_KEY_HERE' \
  -d '{
    "insertion_orders": [
      {
        "advertiser_id": "juIGaOygS0CBBqtmXHamqA",
        "name": "My Insertion Order Name",
        "start_time": "2004-09-22T16:16:42Z",
        "end_time": "2004-09-22T16:16:42Z",
        "contract_number": "C-102930",
        "budget_impressions": "10000",
        "budget_money": {
          "currency_code": "USD",
          "units": "1",
          "nanos": 750000000
        }
      }
    ]
  }'

Responses

A successful response.

Bodyapplication/json
insertion_ordersArray of objects(api.dsp.v1.InsertionOrder)
Response
{ "insertion_orders": [ { … } ] }