Method: buyers.finalizedDeals.setReadyToServe

Sets the given finalized deal as ready to serve. By default, deals are ready to serve as soon as they're finalized. A bidder can opt out of this feature by asking to be included in an allowlist. Once opted out, finalized deals belonging to the bidder and its child seats will not start serving until this method is called. This method is useful to the bidders who prefer to not receive bid requests before the creative is ready. This method only applies to programmatic guaranteed deals.

HTTP request


The URL uses gRPC Transcoding syntax.

Path parameters



Required. Format: buyers/{accountId}/finalizedDeals/{dealId}

Request body

The request body must be empty.

Response body

If successful, the response body contains an instance of FinalizedDeal.

Authorization Scopes

Requires the following OAuth scope: