Create Flight

This API call adds a new flight to a campaign.

What are Flights?

A flight is a collection of ads grouped under a campaign. Most targeting and delivery rules are set at the flight level. These rules include items such as:

  • impression goals
  • tracking methods
  • dates to run
  • targeting

For example, if an advertiser wants to place an advertisement for summer clothing, the best time to display the ad may be in the summer months, and not in the autumn or winter months.

Kevel enables users to create flights by either using the Kevel UI or API. This section describes how to use the Create Flight API to create flights.

For more information on flights and how they can be used for optimizing performance using the Kevel UI, please refer to the Kevel UI Flight documentation overview page.

API Syntax

When using the Create Flight API, it is important to understand the syntax required to make the request. Because the Kevel API is a RESTful API, there is a specific request format that must be followed to ensure the endpoint can process the request. The format is:



  • POST - the type of API request being made.
  • - the URL for the request.
  • v1 - the API version.
  • flight - the API endpoint being called.

Flight Fields

There are a number of fields that can be used when creating a flight. These fields are described in detail in the Flight Fields documentation.


Geotargeting is a type of advertising that uses location data to display ads to a user within a specific geographic region. For example, if a user is based in Japan, ads can be directed to users within that region that may be of interest, such as anime, technology, etc.

Although certain assumptions are made about users in a region, geotargeting can be a powerful tool for publishers and advertisers to provide ad inventory to users in different regions and parts of the world.

When a user opts in to location services, this type of advertising allows a publisher or advertiser to be more focused in campaigns to ensure maximum return on investment.

Put simply, geotargeting helps advertisers create more engaging, relevant, targeted advertisements for users, which can result in increased user engagement.



Geotargeting and Site/Zone targeting are set with separate endpoints.

Behavioral Targeting

The Create Flight API also enables behavior targeting through the use of behavioral objects.

The Behavioral object is used for Interest/Behavioral Targeting and Excluding Ads Based on Behavior.

The BehavioralTargeting object contains six boolean statements, three under onClick and three under onConvert. All default to false. All are optional.

onClick: {"stopShowingAdsFromFlight":XX}Stops showing ads from flight if someone clicks.
onClick: {"stopShowingAdsFromAdvertiser":XX}Stops showing ads from advertiser if someone clicks.
onClick: {storeCategoriesFromFlightAsInterest":XX}Saves the category of the flight to UserDB, tied to user, based on click.
onConvert: {"stopShowingAdsFromFlight":XX}Stops showing ads from flight if someone converts.
onConvert: {"stopShowingAdsFromAdvertiser":XX}Stops showing ads from advertiser if someone converts.
onConvert: {"storeCategoriesFromFlightAsInterest":XX}Saves the category of the flight to UserDB, tied to user, based on conversion.
"BehavioralTargeting": {
    "onClick": {
      "stopShowingAdsFromFlight": true,
      "stopShowingAdsFromAdvertiser": true,
      "storeCategoriesFromFlightAsInterest": true
    "onConvert": {
      "stopShowingAdsFromFlight": true,
      "stopShowingAdsFromAdvertiser": true,
      "storeCategoriesFromFlightAsInterest": true