## Overview

When you set up [frequency capping](https://dev.kevel.com/docs/frequency-capping-1), you set the maximum number of times a given ad can be displayed to any particular person in a particular time period.

> 📘
>
> ### Note  
>
> Set caps by **hour**, **day**, or **minute**. Max duration is 180 days, 168 hours, or 4400 minutes.

## Setting Up with UI

1. When creating/editing a Creative, in the Delivery Settings --> Distribution section there is a Frequency Capping toggle
2. Add in the required fields and Save

## Setting Up with API

Use the below parameters in the [Create Ads](https://dev.kevel.co/v1.0/reference/creative-flight-map#create-ads) request.

| Property | Description |
| --- | --- |
| `FreqCap`<br>(integer) | The number of times that you would like the frequency cap to occur |
| `FreqCapDuration`<br>(integer) | How often the frequency cap should occur |
| `FreqCapType`<br>(integer) | Which unit of time you would like frequency capping to occur. Key:<br>`1 = Hour`<br>`2 = Day` |
| `DontAffectParentFreqCap`<br>(boolean) | Optional. If `true`, opts-it out of frequency cap settings imposed at advertiser, campaign, or flight level |

> 📘
>
> ### Note  
>
> To understand frequency capping, use this formula: `Display this advertiser {{FreqCap}} times per {{FreqCapDuration}} {{FreqCapType}}`. For instance: `Display this advertiser 3 times per 6 hours`

Here's an example request for a [Create Ads](https://dev.kevel.com/reference/create-ads) request with frequency cap settings of `10 times per 1 day` and which is opted-out of advertiser/campaign/flight level caps.

JSON

```json
creative={
  "CampaignId":123,
  "Creative":{
    "Id":12345
  },
  "FlightId":1234,
  "IsActive":true,
  "FreqCap": 10,
  "FreqCapDuration": 1,
  "FreqCapType": 2,
  "DontAffectParentFreqCap": true
}
```

You can also update the caps with the [Update Ad](https://dev.kevel.co/v1.0/reference/creative-flight-map#update-ad) request.