Method: advertisers.insertionOrders.create

AI-generated Key Takeaways

• Creates a new insertion order and returns it upon successful completion.

• Requires an HTTP POST request to a specific URL with the advertiser ID as a path parameter.

• The request body must contain an InsertionOrder object, as detailed in the provided documentation.

• A successful response will contain the newly created InsertionOrder object.

• Authorization requires the https://www.googleapis.com/auth/display-video OAuth scope.

Display & Video 360 API v3 is deprecated and will sunset on October 7, 2025. Migrate to Display & Video 360 API v4 before sunset to avoid an interruption in service.

• HTTP request
• Path parameters
• Request body
• Response body
• Authorization scopes
• Try it!

Creates a new insertion order. Returns the newly created insertion order if successful.

HTTP request

POST https://displayvideo.googleapis.com/v3/advertisers/{insertionOrder.advertiserId}/insertionOrders

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
insertionOrder.advertiserId	string (int64 format) Output only. The unique ID of the advertiser the insertion order belongs to.

Request body

The request body contains an instance of InsertionOrder.

Response body

If successful, the response body contains a newly created instance of InsertionOrder.

Authorization scopes

Requires the following OAuth scope:

• https://www.googleapis.com/auth/display-video

For more information, see the OAuth 2.0 Overview.