Create a deal request

Creates the deal in real time and returns the Sovrn external deal ID (SVN_…) synchronously. Pass ?dryRun=true to run the full validation pipeline without creating anything. A request whose buyers include dv360 must also satisfy the DV360 field requirements (see the DV360 buyers section); violations return 400 naming the field. A pmp request whose buyers include thetradedesk needs schedule.endDate, before the same calendar date 2 years after schedule.startDate (see the Trade Desk buyers section). An open request may leave buyers out or send it empty: the deal gets a live deal ID that no buyer receives until a PATCH adds a DSP. A pmp request names at least one buyer.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
string
enum
Defaults to false
Allowed:
Body Params
string
required
length ≥ 1
string
string
enum
Defaults to pmp
Allowed:
string
enum
required
Allowed:
environments
array of objects
required
length ≥ 1
environments*
Allowed:
pricing
object
required
commercial
object
required
schedule
object
required
buyers
array of objects

Required on a pmp deal, with at least one buyer. An open deal may leave it out or send it empty: it gets a live deal ID that no buyer receives until a PATCH adds a DSP.

buyers
const
enum
Allowed:
targeting
array of objects
length between 1 and 25
targeting
string
required
length ≥ 1
rules
array of objects
required
length ≥ 1
rules*
string
enum
required
values
array
required
length ≥ 1
values*
string
enum
Defaults to include
Allowed:
Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

Language
Credentials
Header
LoadingLoading…
Response
Choose an example:
application/json
text/plain