---
title: "Create Priority"
method: POST
path: "/v1/priority"
---

# Create Priority

`POST /v1/priority`

## Request

- Base URL: `https://api.kevel.co`
- URL: `https://api.kevel.co/v1/priority`
- Auth: API key in header `X-Adzerk-ApiKey`

This API call adds a new priority to a specific channel.

## Request body

- object
  - `Name` string, required: The Priority's Name
  - `ChannelId` string, required: The Channel's ID
  - `Weight` integer, required: The priority order within the channel. 1-100, 1 is highest priority
  - `SelectionAlgorithm` integer, required: Choose which selector the ad engines use to select an ad from this priority. Defaults to 0 (lottery). See below for the full list.
  - `IsDeleted` boolean: Do not use if creating a Priority. Defaults to `false`
  - `FloorPrice` number, float: Sets a floor price for second-price auction priority
  - `FloorCPC` number, float: (BETA) Read only - Floor CPC if the Floor CPC feature is used on the priority. Contact Kevel support to get started
  - `IsSecondPricing` boolean: Whether flight uses second-price auction model
  - `SecondPriceGroupBy` string: Sets whether ads in a second-priced auction should *not* second price against the same: `advertiser`, `campaign`, `flight`, or `ad`. Default is `null`, which is equivalent to `advertiser`. Can only be set when `IsSecondPricing` is true
  - `PassbackTimeout` integer: Sets the timeout (in ms) for flights passing back in an adChain priority
  - `RemainderPercentage` integer: Auctions and AdChain Optimized only. Refers to the percentage of impressions that ads with lower eCPMs will receive, which is used to give poor-perfoming ads a "second-chance".

## Response `200`

200

- object
  - `id` integer
  - `name` string
  - `channelId` integer
  - `weight` integer
  - `isDeleted` boolean
  - `selectionAlgorithm` integer

---

[API](https://skmtc.dev/kevel/apis/management-api-2.md) - [All operations](https://skmtc.dev/kevel/apis/management-api-2/llms.txt) - [OpenAPI document](https://skmtc.dev/kevel/apis/management-api-2/revisions/fe6c8716ca08?raw)