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

# Create Priority

`POST /v1/priority`

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.net/kevel/apis/engine-apis.md) · [All operations](https://skmtc.net/kevel/apis/engine-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kevel/engine-apis/versions/0ca55f45aa7d/schema)