post
https://sandbox-api.viantinc.com/{basePath}/adorder//flight
Creates a new Order Flight.
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
Campaign Budget Types
Order Flights inherit their budget type from the Campaign they belong to. The Campaign's budget type determines which budget fields are required:
MONETARY Campaigns
- Required:
maxBudget(in USD) - Optional:
dailyBudget
IMPRESSIONS Campaigns
- Required:
lifetimeImpCap - Optional:
dailyImpCap
The API validates the appropriate fields based on the Campaign's budget type.
Request Body
| Name | Type | Description | Required |
|---|---|---|---|
| budgetType | string |
One of:
|
|
| dailyBudget | string | The daily budget limit in USD. | Optional. Only applicable for MONETARY campaigns. |
| dailyFrontload | integer | ||
| maxBudget | integer | The maximum budget for the order flight in USD. | Required if campaign budget type is MONETARY. |
| dailyImpCap | integer | The daily impressions cap. | Optional. Only applicable for IMPRESSIONS campaigns. |
| lifetimeImpCap | integer | The total lifetime impressions cap for the order flight. | Required if campaign budget type is IMPRESSIONS. |
| startDate | integer | Start date of the order flight, passed as Unix time in milliseconds. | |
| endDate | integer | End date of the order flight, passed as Unix time in milliseconds. |
Examples
Creating an Order Flight for a MONETARY Campaign
{
"budgetType": "FIXED_BUDGET",
"maxBudget": 5000,
"dailyBudget": 500,
"startDate": 1766476800000,
"endDate": 1769088800000
}Creating an Order Flight for an IMPRESSIONS Campaign
{
"budgetType": "FIXED_BUDGET",
"lifetimeImpCap": 100000,
"dailyImpCap": 10000,
"startDate": 1766476800000,
"endDate": 1769088800000
} 401Unauthorized
403Forbidden
404Not Found