---
title: "Create Advertisers"
method: POST
path: "/v1/advertiser/"
---

# Create Advertisers

`POST /v1/advertiser/`

## Request body

- object
  - `Title` string, required — The advertiser name
  - `IsActive` boolean, required — Whether advertiser is running. Always set to `true` when creating. Defaults to `false`.
  - `PlacementLimit` integer — How many placements the advertiser's ads can fill per request
  - `FreqCap` integer — The number of times that you would like the frequency cap to occur. Set-up instructions [here](https://dev.adzerk.com/docs/advertiser-frequency-capping-1)
  - `FreqCapDuration` integer — How often the frequency cap should occur. Set-up instructions [here](https://dev.adzerk.com/docs/advertiser-frequency-capping-1)
  - `FreqCapType` integer — The unit of time you would like frequency capping to occur. Key follows: `1 = Hour 2 = Day 3 = Minute`. Set-up instructions [here](https://dev.adzerk.com/docs/advertiser-frequency-capping-1)
  - `CapType` integer — Advertisers can only budget cap on the revenue metric. Set to `CapType = 4`. Do not set to `0` - if removing, set to `null`
  - `DailyCapAmount` integer — The max daily revenue
  - `LifetimeCapAmount` integer — The max lifetime revenue
  - `CustomFieldsJson` string — Sets the value of custom fields based on a custom fields schema. Must contact support before use. More info [here](https://dev.kevel.com/v1.0/docs/custom-fields).
  - `RtbCustomFields` string — Required for RTB enabled advertisers _only_. JSON Object in a String. It's JSON data provided by the RTB partner. Certain parameters in the object will be required per partner. If you aren't sure what is required, your account manager will supply you with the data for this property.
  - `ExternalId` string — Used to reference an ID from another external system
  - `PartnerId` integer — Required for RTB enabled advertisers _only_. The ID of the RTB Partner. If you aren't sure what is required, your account manager will supply you with the data for this property.
  - `IsDeleted` boolean — Whether advertiser is deleted. Defaults to `false`
  - `CatalogAccess` object[] — Define the scope of Catalog items that pertain to an Advertiser.
    - `CatalogId` integer — The ID of a `kevel/products` table in the Advertiser's network
    - `ProductQuery` string[] — A Kevelog where clause.
  - `Segments` object[] — Segments that the advertiser should be able to access when configuring user segment targeting in Kevel Console. These settings do not effect campaigns managed directly through the Ad Server.
    - `SegmentId` integer — ID of the segment.

## Response `200`

200

---

[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)